Comet

Get the latest batch of trends for a comet

Returns every trend detected by the AI in the most recent completed analysis cycle. Each trend includes evidence videos, aggregate engagement stats, a stable_key for time-series joins, and a new/rising/steady/fading status vs. the previous cycle.

get/v1/comet/{id}/trends/latest

Request

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

Path parameters

idstring required

UUID of the comet configuration

Response

Latest batch of trends (may be empty if no analysis has run yet)

Example response

{
  "data": {
    "reference_id": "550e8400-e29b-41d4-a716-446655440000",
    "viral_insight_id": "95f2a50b-8e9f-4a8f-a0d0-14c31d3e82c2",
    "batch_start": "2026-04-14T00:00:00.000Z",
    "batch_end": "2026-04-21T00:00:00.000Z",
    "total": 5,
    "trends": [
      {
        "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"
      }
    ]
  }
}

Changes

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