Search Targeting - Markifact

Searches X Ads targeting values (locations, interests, events, conversation topics, app store categories, network operators, devices, platforms, languages, TV markets and shows) and returns their ids for use in x_ads_set_targeting.


App	X Ads
Operation ID	`x_ads_search_targeting`
Type	Action
Connection	`x_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`target_type`	enum (`LOCATION`, `INTEREST`, `EVENT`, `CONVERSATION`, `APP_STORE_CATEGORY`, `NETWORK_OPERATOR`, `DEVICE`, `PLATFORM`, …)	Yes	-	What to look up. The returned targeting_value ids go into x_ads_set_targeting: LOCATION (countries/regions/metros/cities/postal codes), INTEREST, EVENT, CONVERSATION (topics), APP_STORE_CATEGORY, NETWORK_OPERATOR, DEVICE, PLATFORM, PLATFORM_VERSION, LANGUAGE, TV_MARKET (locales for TV_SHOW), or TV_SHOW. IAB_CATEGORY is the one extra lookup, feeding the categories field the PUBLISHER_NETWORK placement requires on ad groups. Keywords and follower lookalikes need no lookup: keywords are free text and FOLLOWERS_OF_USER / SIMILAR_TO_FOLLOWERS_OF_USER take user ids (use x_ads_get_targeting_suggestions to discover either).
`query`	string	No	-	Keyword to search by. Returns everything available when omitted.
`location_type`	enum (`COUNTRIES`, `REGIONS`, `METROS`, `CITIES`, `POSTAL_CODES`)	No	-	LOCATION only: restrict results to one location granularity.
`country_code`	string	No	-	ISO alpha-2 country code. LOCATION: scope results to the country; NETWORK_OPERATOR: which country’s carriers (default US); EVENT: comma country codes are accepted via this field.
`event_types`	string or array of string	No	-	EVENT only: event types to include (list or comma-separated): CONFERENCE, HOLIDAY, MUSIC_AND_ENTERTAINMENT, OTHER, POLITICS, RECURRING, SPORTS. All types are searched when omitted.
`conversation_type`	string	No	-	CONVERSATION only: restrict to one conversation type, e.g. BRANDS, SPORTS, MUSIC_GENRES, TV_SHOWS, POLITICIANS (see X’s conversation type list).
`os_type`	enum (`ANDROID`, `IOS`)	No	-	APP_STORE_CATEGORY only: which store, ANDROID or IOS.
`locale`	string	No	-	TV_SHOW only (required): a locale from TV_MARKET results, e.g. en-US.
`limit`	integer	No	`100`	Maximum number of targeting values to return. Default: 100.

Output

Type: List[Dict] Returns matching targeting values with their targeting_value ids and names. Fields: dynamic (depend on the inputs)