Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-07-20"

Query Parameters

account_id
string

Account to search on behalf of. Defaults to the authenticated account.

platform
enum<string>
required

The ad network whose targeting taxonomy to search.

Available options:
meta
query
string

The search term. Blank browses the fixed lists; interests and locations return nothing without one.

types
enum<string>[]

Kinds of targeting options to search. Defaults to all of them.

Available options:
interests,
behaviors,
life_events,
industries,
income,
family_statuses,
languages,
locations
location_types
enum<string>[]

Narrow location results to these kinds of places. Only applies when types includes locations.

Available options:
country,
region,
city,
zip
country
string

Narrow location results to one country, as an ISO 3166-1 code such as US. Only applies when types includes locations.

limit
integer
default:25

Maximum number of results per requested type.

Required range: x <= 500

Response

types narrows the search and accepts a comma-separated list

data
(Detailed targeting · object | Language · object | Location · object)[]
required

One result from the ad-group targeting-options search. type picks the shape: detailed-targeting taxonomy options carry the ad platform's id, languages carry an ISO 639 code, and locations carry the platform key plus geographic context.