Content Research Agents

Get an agent’s slideshows

get/v1/agents/{id}/slideshows

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/agents/{id}/slideshows
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

min_viewsnumber

Example:100000

Minimum view count filter (read-time).

platformsstring[]

Filter by platform(s).

start_datestring

Example:2026-01-01T00:00:00Z

Only videos published on/after this date (ISO string).

end_datestring

Example:2026-06-30T23:59:59Z

Only videos published on/before this date (ISO string).

order_by'publish_date' | 'views' | 'created_at'

Field to sort by.

sort'asc' | 'desc'

Sort direction.

intent_matchboolean

Filter by intent-match result. Only meaningful when the agent used data_intelligence_enabled. true = matching only, false = non-matching.

regionstring

Example:US

Filter by resolved upload region (ISO-3166-1 alpha-2, e.g. US, CA, RU, AU). Case-insensitive; normalized to uppercase.

Response

Slideshows

Example response

{
  "data": {
    "slideshows": [
      {
        "author": {
          "username": "creator_handle",
          "avatar_url": "https://auth.virlo.ai/storage/v1/object/public/avatars/abc.jpg",
          "followers": 160726,
          "country": "US"
        },
        "region": "US"
      }
    ]
  }
}

Changes

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