# Pinterest API

Extract public Pinterest profiles, boards, sections, and pin metadata.

- Platform ID: `pinterest`
- Capabilities: 9
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [Get full board](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.board-full.get)

- Capability ID: `pinterest.board-full.get`
- Cost: 1 credit per request

Collect public board pins and section memberships in resumable chunks of up to 1,000 pins, with explicit completeness.
### [Get board ID](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.board-id.get)

- Capability ID: `pinterest.board-id.get`
- Cost: 1 credit per request

Extracts the numeric board ID from a Pinterest board URL. The board ID is required for some API operations and is extracted from the page's embedded data.
### [Get board info](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.board-info.get)

- Capability ID: `pinterest.board-info.get`
- Cost: 1 credit per request

Read one public board’s metadata, reported pin count and sections before collecting its pins.
### [List board pins](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.board-pins.list)

- Capability ID: `pinterest.board-pins.list`
- Cost: 1 credit per request

Read up to 250 board pins per page, with a continuation cursor, explicit completeness and image or video evidence.
### [Get pin](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.pin.get)

- Capability ID: `pinterest.pin.get`
- Cost: 1 credit per request

Read a public pin’s metadata, images and video evidence, including a video URL when available.
### [List section pins](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.section-pins.list)

- Capability ID: `pinterest.section-pins.list`
- Cost: 1 credit per request

Read up to 50 section pins per page, with a continuation cursor and explicit media and completeness evidence.
### [Get section](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.section.get)

- Capability ID: `pinterest.section.get`
- Cost: 1 credit per request

Collect section pins in resumable chunks of up to 1,000, with reported counts and explicit incomplete outcomes.
### [Get user boards](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.user-boards.get)

- Capability ID: `pinterest.user-boards.get`
- Cost: 1 credit per request

List a public profile’s boards with IDs, URLs, pin counts and section counts for board discovery and collection.
### [Get user](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.user.get)

- Capability ID: `pinterest.user.get`
- Cost: 1 credit per request

Read a public profile’s username, display name, follower count, image and verification status from its Pinterest URL.

## Common uses

- Monitor brand-owned Pinterest profiles and boards
- Analyze board structure, sections, and publishing volume
- Collect public pin metadata and media URLs
- Archive public board content for creative research

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).