Content Research Agents

Get the latest batch of trends for an agent

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/agents/{id}/trends/latest

Request

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

Path parameters

idstring required

Agent UUID

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.