Search Targeting - Markifact

Searches Spotify targeting options (artists, genres, geos, interests, languages, playlists, podcast episode topics, sensitive topics) and returns their ids for use in the targets object of spotify_ads_create_ad_set.


App	Spotify Ads
Operation ID	`spotify_ads_search_targeting`
Type	Action
Connection	`spotify_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`target_type`	enum (`ARTIST`, `GENRE`, `GEO`, `INTEREST`, `LANGUAGE`, `PLAYLIST`, `EPISODE_TOPIC`, `SENSITIVE_TOPIC`, …)	Yes	-	What to look up: ARTIST, GENRE, GEO, INTEREST, LANGUAGE, PLAYLIST, EPISODE_TOPIC, or SENSITIVE_TOPIC for targeting ids used in the targets object of spotify_ads_create_ad_set, or AD_CATEGORY for the advertising category code that ad set takes in its category field.
`query`	string	No	-	Keyword to search by, matched case-insensitively. Returns everything available when omitted, except for GEO which requires at least one filter.
`ids`	string or array of string	No	-	Look up specific target ids instead of searching. Accepts a list or a comma-separated string.
`country_code`	string	No	-	GEO only: restrict results to an ISO alpha-2 country code, for example US.
`geo_types`	array of string or SelectableOption	No	-	GEO only: restrict results to these geo types: CITY, COUNTRY, DMA_REGION, POSTAL_CODE, REGION.
`limit`	integer	No	`100`	Maximum number of targets to return. Default: 100.

SelectableOption

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

Output

Type: List[Dict] Returns matching targets with their id and name; geos also include type, country_code and parent_geo_name, artists include images, and interests include their subtargets. Fields: dynamic (depend on the inputs)