See what's climbing before it peaks.

One call, one answer to "what is blowing up right now?" — hashtags, creators and sounds mixed together, ranked by their last-hour climb plus acceleration.

copycurl -s "https://api.metrix.ac/api/v1/hot?limit=10" \
  -H "Authorization: Bearer $TM_API_KEY"

copy{
  "entity_type": "hashtag",
  "window": "1h",
  "results": [
    { "entity_type": "creator", "entity_id": "adidas", "display_name": "adidas",
      "metrics": { "views": 8583472 } }, // ← ranked by views for creators/sounds
    // ...more entities, mixed types...
  ]
}

Mixed types come back sorted the same list: hashtags by 1h velocity, creators and sounds by view volume. Pass ?entity_type= to restrict to one type.

Use hashtag, creator, or sound for TikTok leaderboards. window is one of 6h, 24h, 72h, or 7d; unsupported values return 400. The former 1-hour choice is not available here—use /hot for the 1-hour pulse.

copycurl -s "https://api.metrix.ac/api/v1/velocity/sound?window=24h&topic_id=food_cooking&limit=5" \
  -H "Authorization: Bearer $TM_API_KEY"

copy{
  "entity_type": "sound",
  "window": "24h",
  "status": "available",
  "status_reason": null,
  "total": 1,
  "results": [
    { "entity_id": "7626892220234943253", "entity_type": "sound",
      "velocity": 530434.78, // ← flat, window-scoped metric
      "acceleration": -46124.76, "momentum": 1102840.23,
      "size_tier": "large", "is_hot": false }
  ]
}

topic_id uses the same catalog visibility gate as niche reads. A stale source does not serve old rows: the envelope returns status: "not_available", status_reason: "stale_source", and an empty results list.

The actual videos behind the numbers above — not just an entity score, but the clips themselves, with view/like/share counts and the hashtags each one used.

copycurl -s "https://api.metrix.ac/api/v1/trending/videos?topic_id=food_cooking&limit=5" \
  -H "Authorization: Bearer $TM_API_KEY"

copy{
  "videos": [
    { "video_id": "7581714645912718623",
      "creator_handle": "yum.bubs", "views": 269400000, "likes": 4600000,
      "hashtags": ["aiasmr", "asmr", "eating", "satisfyingvideo"], "has_media": true }
  ],
  "total": 5,
  "filters": { "topic_id": "food_cooking" }
}

Spot something on a leaderboard and want the full picture? This returns the same entity's numbers for every window at once, so you can tell a spike from a sustained climb.

copycurl -s "https://api.metrix.ac/api/v1/velocity/hashtag/relationships" \
  -H "Authorization: Bearer $TM_API_KEY"

copy{
  "entity_type": "hashtag",
  "entity_id": "relationships",
  "windows": {
    "24h": { "velocity": 128541.43, "acceleration": -12262.94, // ← spike or slowing?
      "pct_change": 2.38, "rank_velocity": 10 },
    "7d":  { "velocity": 252702.69, "acceleration": 3273.04, "rank_velocity": 25 }
  }
}

Pass ?window= to get just one window instead of all four.

Everything from /velocity/{entity_type} above, pre-filtered to a single registry-visible niche.

copycurl -s "https://api.metrix.ac/api/v1/niches/food_cooking/trending?entity_type=hashtag&limit=5" \
  -H "Authorization: Bearer $TM_API_KEY"

copy{
  "entity_type": "hashtag",
  "window": "24h",
  "results": [
    { "entity_id": "relationships", "velocity": 128541.43, // ← the niche's #1 climber
      "acceleration": -12262.94, "size_tier": "xl", "rank_velocity": 10 },
    { "entity_id": "icecream", "velocity": 53176.04, "acceleration": 670.55, "size_tier": "medium" }
  ]
}

Filters to rising entities and sorts by acceleration instead of raw velocity. Results span all size tiers by default; pass ?tier=nano when you specifically want the former nano-only view.

copycurl -s "https://api.metrix.ac/api/v1/niches/food_cooking/rising?entity_type=hashtag&limit=5" \
  -H "Authorization: Bearer $TM_API_KEY"

copy{
  "entity_type": "hashtag",
  "window": "24h",
  "results": [
    { "entity_id": "chipotlehack", "velocity": 0.0, "acceleration": 0.0, // ← nano-tier, hasn't moved yet
      "size_tier": "nano", "rank_velocity": 5088 }
  ]
}

Optional ?tier= values are nano, micro, mini, small, medium, large, and xl.