# Pinterest Board Pins

<p>List the pins saved on one public Pinterest board with images, titles, pinner and board context. Identify the board by board id to keep the request to a single upstream lookup, or by username plus slug. A username plus slug call resolves the board id first; that resolution is cached for an hour on the slug pair and is never billed separately, so one request is always one charge and repeat calls to the same board cost only the pin feed lookup. Advertisements and other non-pin modules are never included.</p>

- **Documentation:** [https://scrappa.co/docs/pinterest-api/pinterest_board_pins](https://scrappa.co/docs/pinterest-api/pinterest_board_pins)
- **API group:** Pinterest API
- **Endpoint:** `GET https://scrappa.co/api/pinterest/board/pins`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `board_id` | string | No | <p>Numeric Pinterest board id. Recommended: it keeps the request to one upstream lookup. Without it the board id is resolved from username plus slug first, which is cached for an hour and never billed separately.</p> |
| `username` | string | No | <p>Board owner username, without the @ prefix.</p> |
| `slug` | string | No | <p>Board slug, as it appears in the board URL.</p> |
| `limit` | integer | No | <p>Number of items to request (max 250). Default: 25.</p> |
| `bookmark` | string | No | <p>Pagination token from a previous response.</p> |

## Example response

```json
{
    "pins": [
        {
            "id": "1900024839723552",
            "link": "https://example.com/home-decor",
            "board": {
                "id": "1900093532251547",
                "url": "/haliexo/living-room-inspo/",
                "name": "Living room Inspo"
            },
            "likes": 86,
            "saves": 1204,
            "title": "Minimalist living room ideas",
            "domain": "example.com",
            "pinner": {
                "id": "1900162251230306",
                "source": "closeup_attribution",
                "username": "haliexo",
                "full_name": "Halie Jo",
                "profile_url": "https://www.pinterest.com/haliexo/"
            },
            "comments": 12,
            "hashtags": [
                "minimalist",
                "livingroom"
            ],
            "is_video": false,
            "image_url": "https://i.pinimg.com/736x/92/b0/a0/92b0a0b84696442d78be0737e1d0bf06.jpg",
            "description": "Clean lines and neutral tones for a modern living room."
        }
    ],
    "count": 1,
    "success": true,
    "board_id": "1900093532251547",
    "nextBookmark": null
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)