List Pins

Lists the account’s pins as Pinterest returns them, with media, title, description, link, and board

Lists the account’s pins as Pinterest returns them, with media, title, description, link, and board. Pass a board to list only that board’s pins. Turn on include_metrics to get each pin’s lifetime impressions, saves, and clicks, which is how to measure more pins than the 50 pinterest_get_report returns at pin level.

App	Pinterest Organic
Operation ID	pinterest_list_pins
Type	Action
Connection	pinterest (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
board	string or SelectItem	No	-	Optional board id, which pinterest_list_boards returns. When set, only that board’s pins are listed. Leave empty to list the pins across the whole account.
include_metrics	boolean	No	-	Set to True to include each pin’s lifetime metrics (impressions, saves, pin clicks, outbound clicks) alongside the pin. This is the way to measure more than the 50 pins pinterest_get_report returns at pin level.
limit	integer	No	100	Maximum number of pins to return, between 1 and 500. Default is 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 pins exactly as Pinterest returns them.

Fields: dynamic (depend on the inputs)

Example:

[
  {
    "id": "813744226420795884",
    "created_at": "2026-08-01T10:00:00",
    "link": "https://example.com/recipe",
    "title": "Autumn recipes",
    "board_id": "549755885175"
  }
]