# Pinterest API

Scraper module for Pinterest content including users, boards, pins, and sections with streaming support

- Platform ID: `pinterest`
- Capabilities: 7
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/pinterest/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [Get Full Board](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.board-full.get) | `pinterest.board-full.get` | 1 credit per request | Fetches complete board data including all pins and sections. IMPORTANT: 'pins' contains board-level pins NOT in any section. Section-specific pins are nested inside 'sections[].pins'. This separation preserves the exact board organization. Also returns summary statistics. |
| [Get Board ID](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.board-id.get) | `pinterest.board-id.get` | 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) | `pinterest.board-info.get` | 1 credit per request | Fetches board metadata without pins. Returns board name, description, pin count, section count, owner, privacy setting, cover images, and section list with pin counts. |
| [Get Pin](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.pin.get) | `pinterest.pin.get` | 1 credit per request | Fetches complete metadata for a single Pinterest pin including title, description, images at multiple resolutions, engagement metrics (saves, repins), creator info, rich metadata (for articles/products), and video URL for video pins. |
| [Get Section](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.section.get) | `pinterest.section.get` | 1 credit per request | Fetches a board section with all its pins. Returns section metadata (title, slug, pin count) and complete pin data for all pins in that section. |
| [Get User Boards](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.user-boards.get) | `pinterest.user-boards.get` | 1 credit per request | Fetches all public boards for a Pinterest user. Returns board metadata including name, description, pin count, section count, privacy setting, cover image, and owner information. |
| [Get User](https://docs.upscrape.com/docs/platforms/pinterest/pinterest.user.get) | `pinterest.user.get` | 1 credit per request | Fetches a Pinterest user's public profile data including username, display name, follower count, profile image URL, and verification status (partner, merchant, domain verified). |


## 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).