List targeting options

What it does

Request

GET /ad-accounts/{acc}/targeting-options 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

• platform string query required

  tiktok or snapchat

  One of tiktok, snapchat

• type string query required

  TikTok: interests, behaviors, languages. Snapchat: interests, countries

  One of interests, behaviors, languages, countries

• country string query optional

  Snapchat interests: the targeted country, as the app reads them (its first targeted country)

  Matches ^[A-Za-z]{2}$

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 (6)

  • id string

    The id or code to put in the launch plan field use

  • use string

    The launch plan field it goes in, e.g. tiktok.adgroup_settings.interest_category_ids

  • name string or null
  • level number or null
  • description string or null
  • scene 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/targeting-options?platform=tiktok&type=interests' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

{
  "data": [
    {
      "id": "120200000000000001",
      "name": "Nordlicht | Spring launch",
      "use": "120200000000000001",
      "level": 1,
      "description": "Example text",
      "scene": "120200000000000001"
    }
  ],
  "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_targeting: TikTok interests, behaviors and languages, Snapchat interests and countries, with the launch field their ids go in. Meta's targeting: search_targeting.

Related operations

• List ad accounts: GET /ad-accounts
• List pages: GET /ad-accounts/{acc}/pages
• List pixels: GET /ad-accounts/{acc}/pixels
• Get pixel events: GET /ad-accounts/{acc}/pixels/{pixel}/events
• List catalogs: GET /ad-accounts/{acc}/catalogs
• List product sets: GET /catalogs/{id}/product-sets
• List custom audiences: GET /ad-accounts/{acc}/custom-audiences
• List templates: GET /ad-accounts/{acc}/templates
• List naming conventions: GET /ad-accounts/{acc}/naming-conventions
• List instagram accounts: GET /pages/{page}/instagram-accounts
• List lead forms: GET /pages/{page}/lead-forms
• List partnership creators: GET /pages/{page}/partnership-creators
• List ad posts: GET /ad-accounts/{acc}/posts
• List page posts: GET /pages/{page}/posts
• Search targeting: GET /targeting/search