> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/pinterest>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/pinterest.mdx>

---

# Pinterest API. See what people plan to buy.

Pin search, pin details, boards and board pins as JSON in one request. No Pinterest developer app and no OAuth.

- No developer app
- Search, pins and boards

Pinterest surfaces product discovery via mood boards, saved pins, and keyword search. Social Fetch exposes four GET routes under `/v1/pinterest/...`: search pins by query, hydrate a pin URL, list boards on a handle, and walk pins on a board URL. Responses include `data.lookupStatus`, `meta.requestId`, and `meta.creditsCharged`.

The same API key covers the rest of the marketplace catalog (25 platforms, 264 endpoints). Write access, ads, and authenticated board management stay with Pinterest's official developer products.

## What you can get

- Keyword pin search for trend, assortment, and campaign discovery.
- Single pin detail by public URL — title, images, outbound link, saves.
- Profile board catalogs by Pinterest username (name, URL, pin count, cover).
- Board pin lists by board URL with cursor pagination.
- Shared `{ data, meta }` envelope with Instagram, TikTok, and the rest of the catalog.
- Public data only — secret boards and private pins are out of scope.

## Pinterest endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Profile boards | GET /v1/pinterest/profiles/{handle}/boards | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/pinterest/profiles/handle/boards/get) |
| Board pins | GET /v1/pinterest/boards/pins | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/pinterest/boards/pins/get) |
| Pin | GET /v1/pinterest/pins | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/pinterest/pins/get) |
| Search | GET /v1/pinterest/search | 1 credit Failed requests are free | [docs](https://www.socialfetch.dev/docs/api/v1/pinterest/search/get) |

## How to start

1. **Create a key and smoke-test search.** Sign up at Social Fetch and copy an `sfk_…` key. New accounts get 100 free credits. Start with `GET /v1/pinterest/search?query=…` against a real product or seasonal term so you see pin rows, cursors, and `meta.creditsCharged` before you wire batch jobs.
2. **Follow the pin → board path.** Hydrate a pin URL with `GET /v1/pinterest/pins`. For a brand or creator handle, call `GET /v1/pinterest/profiles/{handle}/boards`, then `GET /v1/pinterest/boards/pins` with each public board URL. Pass `x-api-key` on every call; paginate with the documented `cursor` when `data.page.hasMore` is true.
3. **Join pins to commerce rows.** Branch on `data.lookupStatus` before upserting. Store outbound `link` / `domain`, image URLs, save metrics, and board identity beside SKUs or creator IDs. Log `meta.requestId` on bad rows so support can trace the exact call.

## Pricing

Pinterest routes charge credits per completed lookup (including `not_found` when the request finished). Pin search, pin detail, profile boards, and board pins are documented at 1 credit each on successful completed calls — always trust `meta.creditsCharged` over a spreadsheet. Credits never expire on pay-as-you-go packs. Signup includes 100 free credits.

## Compared with the official API

Pinterest's developer platform is for apps that publish, manage boards, run ads, or act with user OAuth. Social Fetch looks up publicly visible pages without OAuth and returns the same envelope as Instagram and TikTok.

## FAQ

### Is there a Pinterest scraper API that works without OAuth?

Yes. Social Fetch Pinterest routes read public pin and board data. You authenticate to Social Fetch with an API key (`x-api-key`). You do not OAuth as the Pinterest user whose public pins or boards you are fetching.

### What Pinterest data does Social Fetch cover?

Four marketplace operations: keyword pin search (`GET /v1/pinterest/search`), single pin by URL (`GET /v1/pinterest/pins`), boards for a profile handle (`GET /v1/pinterest/profiles/{handle}/boards`), and pins on a board URL (`GET /v1/pinterest/boards/pins`). Exact paths, parameters, and examples live under `/docs/api` and on this hub's endpoint list.

### Can I search Pinterest pins by keyword via API?

Yes. `GET /v1/pinterest/search` takes a required `query` string and returns matching public pins in the shared envelope. Pass `cursor` when `data.page.hasMore` is true to walk the next page. Optional `trim` shrinks the payload when you only need a subset of fields.

### How do I get metadata for one Pinterest pin?

Call `GET /v1/pinterest/pins` with a public pin `url` (typically `https://www.pinterest.com/pin/{id}/`). Branch on `data.lookupStatus`, then read `data.pin` for title, description, image renditions, outbound link and domain, board summary, pinner, and metrics such as saves and repins.

### How do I list boards for a Pinterest profile?

Use `GET /v1/pinterest/profiles/{handle}/boards` with the Pinterest username in the path. On a found lookup, `data.boards` can include name, url, pinCount, cover image, and related fields. Paginate with `cursor` when more pages exist. This route lists boards — not the pins inside them.

### How do I pull all pins from a Pinterest board?

Pass the public board URL to `GET /v1/pinterest/boards/pins`. Walk pages with `cursor` until `hasMore` is false or your job hits a limit. Use this after you already have a board link from a profile boards list, a shared URL, or a watchlist.

### How much does the Pinterest API cost on Social Fetch?

You buy credit packs (or spend the 100 free signup credits). Documented Pinterest lookups are typically 1 credit per successful completed request. Empty or `not_found` completed lookups still bill when the attempt finishes — check `meta.creditsCharged`. There is no required monthly subscription for pay-as-you-go packs.

### Pinterest official API vs Social Fetch — which should I use?

Use Pinterest's official APIs when you need publishing, ads, or authenticated board management for users who authorize your app. Use Social Fetch when you need public pin search, pin detail, and board enrichment without building a Pinterest OAuth app — especially when those rows must sit next to Instagram and TikTok in one warehouse schema.

### Are secret boards or private pins supported?

No. Only publicly visible profiles, pins, and boards. Secret boards, private pins, and deleted collections resolve as `not_found` (or equivalent typed outcomes) rather than inventing empty data.

### Is scraping Pinterest data legal?

Social Fetch returns publicly visible data. You are responsible for how you use it under Pinterest's terms, applicable law, and your own compliance review. We do not give legal advice.

## Related

- [Pinterest pin search API](https://www.socialfetch.dev/platforms/pinterest/search): Keyword search overlay — query, cursor, trim.
- [Pinterest pin detail API](https://www.socialfetch.dev/platforms/pinterest/pins): Single pin by public URL.
- [Pinterest profile boards API](https://www.socialfetch.dev/platforms/pinterest/profiles-handle-boards): Board catalog for a username.
- [Pinterest board pins API](https://www.socialfetch.dev/platforms/pinterest/boards-pins): Pins on a public board URL.
- [Pinterest API pricing guide](https://www.socialfetch.dev/blog/pinterest-api-pricing): Official Pinterest developer access vs public pin enrichment — when to stay official, when Social Fetch fits.
- [Ask](https://www.socialfetch.dev/ask): Route a natural-language question to the right typed operation.
- [MCP](https://www.socialfetch.dev/mcp): Connect Social Fetch tools in Cursor, Claude, and agents.
- [Brand monitoring recipe](https://www.socialfetch.dev/docs/recipes/brand-monitoring): Ask once, then poll search routes on a schedule.
- [Competitor profile tracking recipe](https://www.socialfetch.dev/docs/recipes/competitor-profile-tracking): Fan-out patterns across networks with one API key.