Skip to main content
POST
ads.targeting.search

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string

Optional. A retry with the same key returns the stored result.

Maximum string length: 255
Pramaan-Max-Price-Micro
string

Optional. The most this request may be priced at, in micro-USD (a whole number above 0). It replaces the capability's own price ceiling for this request, lower or higher. Sources that could cost more are left out; when none is left the answer is 400 with the lowest limit that would work.

Pattern: ^[1-9]\d{0,14}$

Body

application/json
accountId
string
required

Connected account from social.accounts.list.

Required string length: 1 - 256
query
string
required

Name or prefixed targeting ids to look up.

Required string length: 1 - 1000
adAccountId
string

Advertiser to search when the connection holds several.

Required string length: 1 - 256
geoType
enum<string>

Geographic level to search.

Available options:
all,
country,
country_group,
region,
city,
subcity,
neighborhood,
place,
zip,
metro_area,
geo_market
countryCode
string

Country for geographic results.

Required string length: 1 - 2
Pattern: ^[A-Za-z]{2}$
locale
string

Language and locale for results.

Required string length: 1 - 32
dimension
enum<string>
default:interest

Kind of targeting option. Additional interests and hashtags are supported on TikTok.

Available options:
interest,
interestKeyword,
interestSuggestion,
hashtag,
behavior,
geo,
income,
language,
workPosition,
workEmployer,
workIndustry,
industry,
jobFunction,
seniority,
companySize,
skill,
community,
conversationKeyword
limit
number

Maximum results, 1 to 100; default 25.

Required range: x >= 1

Response

The result

results
object[]
required

Matching targeting options.