REST API · Ad accounts

Search targeting

Search Meta targeting: countries, locations (regions, cities), interests, behaviors, demographics, locales

GEThttps://api.apogee.ad/api/v1/targeting/search

Request

GET /targeting/search on https://api.apogee.ad/api/v1.

limit integer query optional

Page size

Default 50

1 to 200
cursor string query optional

next_cursor of the previous page
type string query required

One of countries, locations, interests, locales, behaviors, demographics
q string query optional

Required except for behaviors and demographics

up to 100 characters

Authorization string header required

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

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

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

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

Status	Possible codes
400 Bad request	`idempotency_key_required`, `not_supported`, `request_refused`, `validation_failed`
401 Unauthorized	`invalid_api_key`
403 Forbidden	`account_not_connected`, `forbidden`, `insufficient_scope`, `meta_permission_denied`, `platform_permission_denied`, `upgrade_required`
404 Not found	`not_found`
412 Precondition failed	`drive_not_connected`, `meta_not_connected`, `platform_not_connected`
429 Too many requests	`daily_read_cap`, `meta_rate_limited`, `platform_rate_limited`, `quota_exceeded`, `rate_limited`
500 Internal server error	`internal_error`
502 Bad gateway	`drive_error`, `launch_failed`, `meta_error`, `platform_error`, `upstream_error`

With your key in APOGEE_API_KEY (create one):

Request

curl 'https://api.apogee.ad/api/v1/targeting/search?type=countries' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

Response 200 (shape)

{
  "data": [
    {}
  ],
  "has_more": false,
  "next_cursor": null
}

Plans	Pro and Scale.
Scope	`read` (scopes).
Credits	Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A request that fails costs nothing, a replayed one neither (credits).
Rate limit	Read: 600 per 15 minutes on Pro, 1,200 on Scale (rate limits).
Meta budget	Reads Meta: spends 1 unit of the account's Meta budget (1,800 per 15 minutes, 900 per ad account).
Daily cap	Counts 1 unit toward the 2,000 units one API key can use in 24 hours.

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

search_targeting: Countries, regions and cities, interests, behaviors, life events and languages, with the keys a launch takes.