Orbit

Get ads for a keyword search

Retrieves Meta ads linked to a keyword search with pagination and sorting.

get/v1/orbit/{orbit_id}/ads

Request

Base URL: https://api.virlo.ai
URL: https://api.virlo.ai/v1/orbit/{orbit_id}/ads
Auth: HTTP bearer

Path parameters

orbit_idstring required

Orbit search ID (UUID) returned when the search was created.

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

order_by'created_at' | 'page_like_count'

Example:created_at

Field to sort by

sort'asc' | 'desc'

Example:desc

Sort direction

Response

Successfully retrieved ads

Example response

{
  "data": {
    "orbit_id": "550e8400-e29b-41d4-a716-446655440000",
    "total": 30,
    "limit": 50,
    "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",
        "keyword_found_by": "fitness tips"
      }
    ]
  }
}

Changes

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