# Pinterest API — UnifAPI

> Pins, boards, search. Search Pinterest pins by keyword, list a user's boards and the pins on each board, and fetch single pins with images, links and save counts.

- Category: Social platforms
- API base URL: https://api.unifapi.com
- Auth: `Authorization: Bearer <UnifAPI API key>` (OAuth recommended for MCP clients)
- MCP server: https://mcp.unifapi.com
- Developer docs: https://docs.unifapi.com/api/pinterest
- OpenAPI spec: https://unifapi.com/openapi.json
- HTML page: https://unifapi.com/apis/pinterest
- Full catalog: https://unifapi.com/apis.md

## Agent workflows

- Find what people save for a product category, style or season with keyword pin search and save counts.
- Audit a brand's or creator's boards and the pins on each board for visual merchandising research.
- Trace a pin back to its source domain and link to see which sites drive visual discovery traffic.

## Endpoints (4)

Every endpoint returns the UnifAPI JSON envelope (`request_id`, `data`, `pagination` on lists, `billing`) and bills max(records × credits per record, minimum) in credits.

### Get a Pinterest pin

`GET /pinterest/pins/{id}`

Returns one public Pinterest pin by id: image, title, description, link, board, pinner and save counts. Returns `not_found` when the pin does not exist.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `id` (path)
- Details: https://unifapi.com/apis/pinterest/pins/id/get
- Docs: https://docs.unifapi.com/api/pinterest/pins/id/get

### Search Pinterest pins

`GET /pinterest/search/pins`

Returns public Pinterest pins that match a keyword, with images, titles and links. Paginate with `cursor`.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `query` (query)
- Details: https://unifapi.com/apis/pinterest/search/pins/get
- Docs: https://docs.unifapi.com/api/pinterest/search/pins/get

### List a Pinterest user's boards

`GET /pinterest/users/{username}/boards`

Returns the public boards of a Pinterest user with names, pin counts and cover images. Paginate with `cursor`.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path)
- Details: https://unifapi.com/apis/pinterest/users/username/boards/get
- Docs: https://docs.unifapi.com/api/pinterest/users/username/boards/get

### List pins on a Pinterest board

`GET /pinterest/users/{username}/boards/{board}/pins`

Returns the public pins on a Pinterest board with images, titles, links and save counts. Paginate with `cursor`.

- Price: 1 credit per record, minimum 3 credits ($0.003) per call
- Required: `username` (path), `board` (path)
- Details: https://unifapi.com/apis/pinterest/users/username/boards/board/pins/get
- Docs: https://docs.unifapi.com/api/pinterest/users/username/boards/board/pins/get

## Related APIs

- [Snapchat API](https://unifapi.com/apis/snapchat/index.md) — Public profiles, Spotlight videos, comments
- [Bluesky API](https://unifapi.com/apis/bluesky/index.md) — Profiles, posts, replies
- [Telegram API](https://unifapi.com/apis/telegram/index.md) — Public channels, posts, reactions
- [Facebook API](https://unifapi.com/apis/facebook/index.md) — Pages, posts, reels, groups, events, Marketplace, Ad Library
- [Truth Social API](https://unifapi.com/apis/truth-social/index.md) — Profiles, posts, engagement
- [Reddit API](https://unifapi.com/apis/reddit/index.md) — Subreddits, posts, comments, feeds, search