# Pinterest User Boards API (https://www.socialcrawl.dev/platforms/pinterest/user-boards)

> Returns boards created by a Pinterest user. Each board includes title, description, pin count, and cover image.

TL;DR: `GET /v1/pinterest/user/boards` 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 |
| --- | --- | --- |
| `handle` | yes | The username of the user to get boards for. (e.g. broadstbullycom from https://www.pinterest.com/broadstbullycom/) |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/pinterest/user/boards?handle=pinterest" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I list every board a Pinterest user created?

Send a GET request to /v1/pinterest/user/boards with the user's handle in the handle parameter. SocialCrawl returns every public board on the account with title, description, pin count, and cover image URL.

### What fields does each Pinterest board include?

Each board returns id, name, description, pin count, URL, cover image, and creator info. Everything uses the unified SocialCrawl schema so you can sort by pin count or filter by keyword client-side without extra work.

### How do I find a Pinterest user's handle?

The handle is the segment after pinterest.com/ in a user's profile URL — e.g., pinterest for pinterest.com/pinterest. Paste the handle into the parameter and the endpoint returns their full list of public boards.

### Can I trim the user boards response?

Yes. Pass trim=true and the endpoint returns a compact payload with only the essential fields. Handy when you're building a creator directory or a boards picker UI that only needs names and cover images.

### How much does the Pinterest User Boards API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required — enough to map around 100 Pinterest creators' boards 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 list a Pinterest user's boards with an API
- What does the SocialCrawl Pinterest user/boards endpoint return?