Content Research Agents

Get a content research agent

Returns the agent config, autonomy state, latest run, and async status. finalized: true means the latest run (scrape + AI analysis) is fully settled.

get/v1/agents/{id}

Request

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

Path parameters

idstring required

Agent UUID

Response

Agent

Example response

{
  "data": {
    "keywords": [
      "protein recipes",
      "meal prep"
    ],
    "platforms": [
      "tiktok",
      "youtube",
      "instagram"
    ],
    "intent_keywords": [
      "high protein recipe",
      "protein meal prep",
      "protein dessert"
    ],
    "pinned_keywords": [
      "protein recipe",
      "highprotein"
    ],
    "latest_run": {
      "keyword_breakdown": [
        {
          "keyword": "high protein recipe",
          "videos_inserted": 41,
          "videos_updated": 12,
          "tiktok_count": 27,
          "youtube_count": 12,
          "instagram_count": 2
        }
      ]
    },
    "pending_jobs": [
      {
        "type": "viral_analysis",
        "status": "processing",
        "job_id": "aud_01HXYZ",
        "poll_url": "/v1/orbit/orb_01HXYZ/analysis/latest",
        "result_path": "data.analysis_data",
        "webhook_event": "orbit.run.completed",
        "started_at": "2026-05-22T05:00:00.000Z",
        "retry_after_seconds": 15
      }
    ],
    "progress_pct": 75,
    "eta_seconds": 540
  }
}

Changes

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