Search Targeting

Search or list Pinterest Ads targeting options such as interests, locations, regions, languages, devices, and audiences

Search or list Pinterest Ads targeting options such as interests, locations, regions, languages, devices, and audiences. Returned IDs plug directly into the matching targeting_spec key of pinterest_ads_create_ad_group.

App	Pinterest Ads
Operation ID	pinterest_ads_search_targeting
Type	Action
Connection	pinterest_ads (required)
Credits per run	Free
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select Pinterest Ads account to search targeting options for.
targeting_type	string or SelectableOption	Yes	-	Which targeting dimension to search. The returned IDs go directly into the matching create_ad_group targeting_spec key: INTEREST (interest IDs), LOCATION (country and metro codes), GEO (region and postal codes), LOCALE (language codes), APPTYPE (devices), GENDER, AGE_BUCKET, AUDIENCE_INCLUDE or AUDIENCE_EXCLUDE (the account’s customer lists).
search_query	string	No	-	Optional text filter. Pinterest returns the full list per targeting type, so Markifact filters it: case-insensitive name substring match, or exact ID match.
limit	integer	No	100	Maximum rows to return, sorted by name. Default 100, max 1000.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns Pinterest targeting options normalized for use in ad group targeting_spec keys.

Fields: id, name, targeting_type