List ads

What it does

Request

GET /ad-accounts/{acc}/ads on https://api.apogee.ad/api/v1.

Path parameters

• acc string path required

  Ad account id: Meta act_…, a TikTok advertiser id or a Snapchat ad account id (GET /ad-accounts?platform=…)

  Matches ^(act_\d{1,32}|[A-Za-z0-9][A-Za-z0-9-]{0,63})$

Query parameters

• limit integer query optional

  Page size

  Default 50

  1 to 200

• cursor string query optional

  next_cursor of the previous page

• search string query optional

  Filter on the name (contains, case-insensitive)

  up to 100 characters

• campaign_id string query optional

  Matches ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

• adset_id string query optional

  Matches ^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$

• platform string query optional

  meta (default), tiktok or snapchat

  One of meta, tiktok, snapchat

Headers

• Authorization string header required

  Bearer apk_…: an API key with the scope of this route.

Response

200. A page of results: pass next_cursor as cursor for the next one, limit from 1 to 200 (default 50).

• data array of objects
  Fields of each item (3)

  • id string
  • name string or null
  • status string or null
• has_more boolean
• next_cursor string or null

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Example

With your key in APOGEE_API_KEY (create one):

curl 'https://api.apogee.ad/api/v1/ad-accounts/act_1234567890/ads' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

{
  "data": [
    {
      "id": "120200000000000001",
      "name": "Nordlicht | Spring launch",
      "status": "ACTIVE"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Access and cost

In the MCP

An AI assistant does the same with this tool of the MCP server:

• list_ads: The ads of an ad account, a campaign or an ad set (200 at most).

Related operations

• List campaigns: GET /ad-accounts/{acc}/campaigns
• List ad sets: GET /ad-accounts/{acc}/adsets
• Get latest in campaign: GET /ad-accounts/{acc}/campaigns/{id}/latest
• Get an ad set template: GET /adsets/{id}/template
• Get ad template: GET /ads/{id}/template