List Keywords - Markifact

Lists keywords for a Pinterest Ads account, optionally scoped to a campaign or ad group and filtered by match type. Returns keyword IDs for use with pinterest_ads_update_keywords.


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

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	Select the Pinterest Ads account whose keywords should be listed.
`campaign_id`	string or SelectItem	No	-	Optional campaign ID to list keywords from (campaign-level negative keywords).
`ad_group_id`	string or SelectItem	No	-	Optional ad group ID to list keywords from.
`match_types`	array of string (also accepts a comma-separated string)	No	-	Optional match types to filter by, as a list or comma-separated text. Options: BROAD, PHRASE, EXACT, EXACT_NEGATIVE, PHRASE_NEGATIVE. Returns all match types when omitted.
`limit`	integer	No	`100`	Maximum number of keywords to return. Default: 100.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: List[Dict] Returns the raw list of Pinterest keywords with id, value, match_type, parent_id, and archived.