> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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**:

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