List Pins

Lists the user’s organic Pinterest Pins with title, description, link, and media details, optionally with organic metrics

Lists the user’s organic Pinterest Pins with title, description, link, and media details, optionally with organic metrics. Use it to find Pin IDs to promote with pinterest_ads_create_ad_from_pin.

App	Pinterest Ads
Operation ID	pinterest_ads_list_pins
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 context for listing the user’s Pins.
pin_filter	string or SelectableOption	No	-	Optional filter: exclude_native (hide Pins created by the account, keeping repins), exclude_repins (hide saved copies of other people’s Pins), or has_been_promoted (only Pins that have already been used in ads).
include_protected_pins	boolean	No	False	Include protected Pins, such as ad-only Pins created by the ad nodes that do not appear organically. Default false.
pin_metrics	boolean	No	False	Include 90-day and lifetime organic Pin metrics in each row. Default false.
filters	array of FilterItem	No	-	Additional filters to apply when retrieving Pins. The available fields to filter by are: - id: Filter by Pin ID - title: Filter by Pin title - link: Filter by Pin destination link Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST.
limit	integer	No	100	Maximum number of Pins to return. Default: 100.

FilterItem

Field	Type	Required	Default	Description
field	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
operator	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’
value	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

SelectableOption

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

Output

Type: List[Dict]

Returns the raw list of Pins as provided by the Pinterest /pins endpoint.