List Pins - Markifact

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"
  }
]