Content Research Agents

Get a compact, agent-ready summary for an agent

One free call that returns an agent’s whole picture: config + finalized/progress state, the latest run’s headline counts, cheap corpus counts, the top creators and trend themes, and the latest AI-analysis highlight. A convenience digest — use the dedicated videos/creators/trends/analysis endpoints for full, paginated data. Pieces still processing (analysis / trends / outliers) come back null/empty rather than failing the whole summary.

get/v1/agents/{id}/summary

Request

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

Path parameters

idstring required

Agent UUID

Response

Agent summary

Example response

{
  "data": {
    "progress_pct": 75,
    "eta_seconds": 540,
    "top_creators": [
      {
        "platform": "tiktok"
      }
    ],
    "top_trends": [
      {
        "name": "POV cooking with trending audio"
      }
    ]
  }
}

Changes

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