# Pinterest Board API (https://www.socialcrawl.dev/platforms/pinterest/board)

> Returns pins from a Pinterest board. Each pin includes title, image URL, save count, and link destination. Pagination is not currently supported on this endpoint — the upstream returns a single page only.

TL;DR: `GET /v1/pinterest/board` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the Pinterest board |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/pinterest/board?url=https%3A%2F%2Fwww.pinterest.com%2Flizmrodgers%2Fmoms-night%2F" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I scrape a Pinterest board's pins with an API?

Send a GET request to /v1/pinterest/board with the full board URL in the url parameter. SocialCrawl returns every pin on the board with its title, image URL, save count, and outbound link — paginated with a cursor.

### How do I paginate through a large Pinterest board?

Pass the cursor parameter returned in the previous response to fetch the next page. Loop until the response has no cursor — this is the standard pattern for exhausting boards with thousands of pins.

### What data does each board pin include?

Each pin returns id, title, description, image URL at multiple resolutions, save count, author info, and the external link. All fields land in the unified SocialCrawl post schema, identical to the pin endpoint.

### Can I trim the board response for lean JSON?

Yes. Pass trim=true and the endpoint returns a compact payload. Useful when you need just the pin IDs and image URLs — for example, building a visual grid or archiving a board to your own storage.

### How much does the Pinterest Board API cost?

Each page of board pins costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — enough to paginate through about 100 pages of board pins before paying anything.

See the full Pinterest API: https://www.socialcrawl.dev/platforms/pinterest

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to scrape a Pinterest board's pins with an API
- What does the SocialCrawl Pinterest Board endpoint return?