Content Research Agents

Query AI analyses for an agent

Paginated list of every completed analysis batch for this agent, newest first. Use start_date/end_date to window the results.

get/v1/agents/{id}/analysis

Request

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

Path parameters

idstring required

Agent UUID

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

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 analyses

Example response

{
  "data": [
    {
      "id": "95f2a50b-8e9f-4a8f-a0d0-14c31d3e82c2",
      "batch_start": "2026-04-14T00:00:00.000Z",
      "batch_end": "2026-04-21T00:00:00.000Z",
      "analysis": "TikTok creators are leading the week on AI fitness.",
      "video_count": 75,
      "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.