Comet

Query trends for a comet

Paginated list of every trend row produced for this comet, newest first. Use stable_key to isolate a specific recurring trend, or start_date/end_date to window the results.

get/v1/comet/{id}/trends

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/comet/{id}/trends
Auth: HTTP bearer

Path parameters

idstring required

UUID of the comet configuration

Query parameters

limitnumber

Example:50

Maximum number of items to return. Values above 100 are clamped to 100 rather than rejected.

pagenumber

Example:1

Page number for pagination

stable_keystring

Example:ai-fitness-coaching

Filter to a single recurring trend by its stable key. Stable keys are preserved across cycles so this lets callers build a time series for one specific trend.

start_datestring

Example:2026-01-01T00:00:00.000Z

Earliest batch_end (ISO-8601) to include

end_datestring

Example:2026-04-01T00:00:00.000Z

Latest batch_end (ISO-8601) to include

Response

Paginated trends

Example response

{
  "data": [
    {
      "id": "7f4a7c01-2a08-4ef1-9a12-4f8e3a44d65e",
      "viral_insight_id": "95f2a50b-8e9f-4a8f-a0d0-14c31d3e82c2",
      "insight_type": "custom_niche",
      "reference_id": "550e8400-e29b-41d4-a716-446655440000",
      "batch_start": "2026-04-14T00:00:00.000Z",
      "batch_end": "2026-04-21T00:00:00.000Z",
      "rank": 1,
      "stable_key": "ai-fitness-coaching",
      "name": "AI-powered fitness coaching",
      "why_it_works": "Creators are pairing AI-generated plans with relatable before/after content, driving 3x higher completion rates.",
      "tactics": [
        "AI-personalized workout plans",
        "Before/after transformation overlays"
      ],
      "confidence": 0.82,
      "evidence_videos": [
        {
          "id": "37e50cea-3b30-4440-b183-aa37aeddaf32",
          "url": "https://www.tiktok.com/@creator/video/7629442666748513549",
          "platform": "tiktok"
        }
      ],
      "video_count": 12,
      "total_views": 4250000,
      "total_likes": 320000,
      "total_comments": 18500,
      "total_shares": 24000,
      "avg_virality_score": 0.73,
      "platform_breakdown": {
        "tiktok": 7,
        "youtube": 3,
        "instagram": 2
      },
      "top_creators": [
        {
          "username": "@creator_handle",
          "platform": "tiktok",
          "followers": 120000,
          "video_count": 3,
          "total_views": 850000
        }
      ],
      "peak_hour_utc": 19,
      "status": "rising",
      "first_seen_at": "2026-03-10T00:00:00.000Z",
      "prev_video_count": 8,
      "prev_total_views": 2800000,
      "created_at": "2026-04-21T00:15:22.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "total_pages": 3,
    "has_next_page": true
  }
}

Changes

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