Content Research Agents

Get an agent’s Meta ads

get/v1/agents/{id}/ads

Request

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

Path parameters

idstring required

Agent UUID

Query parameters

limitnumber
Example:50

Items to return (1-100, default 50). Values above 100 are clamped.

pagenumber
Example:1

Page number, 1-indexed (default 1).

order_by'created_at' | 'page_like_count'

Sort field. Omit for the default order.

sort'asc' | 'desc'

Sort direction for order_by.

Response

Ads

Example response

{
  "data": {
    "ads": [
      {
        "id": 1234,
        "ad_archive_id": "987654321",
        "page_id": "111222333",
        "is_active": true,
        "start_date": "2026-01-01T00:00:00.000Z",
        "end_date": "2026-02-01T00:00:00.000Z",
        "url": "https://example.com/ad",
        "cta_type": "SHOP_NOW",
        "page_like_count": 50000,
        "created_at": "2026-01-15T10:30:00.000Z"
      }
    ]
  }
}

Changes

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