---
title: "Get emerging trends (what's heating up right now)"
method: GET
path: "/v1/trends/emerging"
tags: ["Trends"]
---

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

`GET /v1/trends/emerging`

## Request

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

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.

## Query parameters

- `region` string
- `limit` number
- `top_exemplars` number

## Response `200`

Successfully retrieved emerging trends

- V1EmergingTrendsResponseDto
  - `region` string, required: Region the emerging trends were pulled from.
  - `generated_at` string, required: When this response was generated (UTC).
  - `data` V1EmergingTrendDto[], required
    - `id` string, required
    - `trend_id` string, required
    - `ranking` number, required: Position of the trend in its daily container.
    - `region` string, required: Region this emerging trend belongs to.
    - `status` 'new' | 'rising', required: Lifecycle status. The emerging feed only returns `new` (just detected) and `rising` (accelerating) trends.
    - `momentum_score` number, required: Normalized 0-1 heat used to rank the emerging list. Uses live momentum when available, otherwise a velocity-band fallback until the first snapshot runs.
    - `views_per_hour` number, nullable: Instantaneous exemplar view growth at the last momentum snapshot. Null before the first snapshot.
    - `detected_at` string, nullable: When this trend was first detected.
    - `last_seen_at` string, nullable: Last intra-day analysis run that re-confirmed this trend.
    - `exemplar_count` number, required: Total exemplar videos linked to this trend.
    - `top_exemplars` V1TrendExemplarVideoDto[], required: Top exemplar videos ordered by views DESC. Capped by the `top_exemplars` query param.
      - `video_id` string, required
      - `url` string, nullable
      - `platform` 'tiktok' | 'youtube' | 'instagram'
      - `views` number, required
      - `thumbnail_url` string, nullable
      - `publish_date` string, nullable
      - `author` V1TrendExemplarAuthorDto
        - `username` string, nullable
        - `avatar_url` string, nullable
        - `verified` boolean, nullable
    - `trend` V1TrendDto, required
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `trend_type` string, required

## Other responses

- `400`: Unknown region code
- `401`: Unauthorized - missing or invalid API key
- `429`: Too many requests - rate limit exceeded

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)