Trends

Get emerging trends (what's heating up right now)

Returns early-stage trends from the current daily container — those with a new or rising lifecycle status — ranked by live momentum heat. Composable with region (e.g. region=gb for "what's emerging in the UK right now"). Momentum is refreshed by a background snapshot loop roughly every 2 hours; this endpoint only reads that maintained state, so it responds fast. Intended for user-triggered, in-product use and is rate-limited per plan.

get/v1/trends/emerging

Request

  • Base URL: https://api.virlo.ai
  • URL: https://api.virlo.ai/v1/trends/emerging
  • Auth: HTTP bearer

Query parameters

regionstring
Example:gb

Trend region to query. Defaults to 'global' — the worldwide feed. Composable with the emerging signal, e.g. region=gb answers "what's emerging in the UK right now". Supported today: 'global', 'us', 'gb', 'au'; see GET /v1/trends/regions for the current list. Unknown codes return a 400 listing the available regions.

limitnumber
Example:20

Maximum number of emerging trends to return, ranked by momentum heat.

top_exemplarsnumber
Example:5

Top N exemplar videos to include per emerging trend, ordered by views DESC. Use 0 to omit exemplars entirely.

Response

Successfully retrieved emerging trends

regionstring required

Region the emerging trends were pulled from.

generated_atstring required

When this response was generated (UTC).

Example response

{
  "region": "gb",
  "generated_at": "2026-07-07T14:22:11.000Z",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "trend_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "ranking": 3,
      "region": "gb",
      "status": "rising",
      "momentum_score": 0.71,
      "views_per_hour": 5200,
      "detected_at": "2026-07-07T09:12:03Z",
      "last_seen_at": "2026-07-07T13:04:41Z",
      "exemplar_count": 42,
      "top_exemplars": [
        {
          "video_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
          "url": "https://www.tiktok.com/@example/video/12345",
          "platform": "tiktok",
          "views": 1240000,
          "thumbnail_url": "https://cdn.virlo.dev/thumbnails/abc.jpg",
          "publish_date": "2026-05-14T17:11:59Z",
          "author": {
            "username": "jane.creator",
            "avatar_url": "https://cdn.virlo.dev/avatars/abc.jpg",
            "verified": true
          }
        }
      ],
      "trend": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "AI-powered fitness coaching",
        "description": "Creators are using AI tools to create personalized workout plans",
        "trend_type": "content_format"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.