List Keywords

Lists keywords for a Pinterest Ads account, optionally scoped to a campaign or ad group and filtered by match type

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.