> **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/search>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/pinterest/search.mdx>

---

# Pinterest Search API

Keyword search for public Pinterest pins — query in, structured pin rows out, same envelope as the rest of the Pinterest tag.

`GET /v1/pinterest/search` takes a required `query` string and returns matching public pins in the shared Social Fetch 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. Branch on `data.lookupStatus` before you write rows, and bill from `meta.creditsCharged`.

This route is keyword pin search. For a known pin URL use `GET /v1/pinterest/pins`. For a profile's boards use `GET /v1/pinterest/profiles/{handle}/boards`, then `GET /v1/pinterest/boards/pins` for pins on a board. All of them share one Social Fetch API key.

## Request

- **Endpoint:** `GET /v1/pinterest/search`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by query
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/pinterest/search/get)
- **Platform page:** [/platforms/pinterest](https://www.socialfetch.dev/platforms/pinterest)

## FAQ

### What does the Pinterest Search API return?

A page of public Pinterest pins that match your keyword query, plus pagination state under data.page (hasMore, nextCursor). Each response uses the shared Social Fetch envelope with data.lookupStatus, meta.requestId, and meta.creditsCharged.

### How do I call Pinterest keyword search?

Send GET /v1/pinterest/search with x-api-key and a required query parameter. Optionally add cursor and trim. Full parameter details and examples are in the API docs.

### How much does Pinterest pin search cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

### Is this the same as fetching a pin by URL?

No. GET /v1/pinterest/search finds pins by keyword. GET /v1/pinterest/pins loads one pin when you already have its public URL.

### How does pagination work on Pinterest search?

When data.page.hasMore is true, pass data.page.nextCursor as the cursor query param on the next request. Keep the same query across pages.

### Can I search private or secret boards?

No. The route only returns publicly visible pin search results. Secret boards and authenticated board management stay with Pinterest's official products.

### Do I need a Pinterest OAuth app to search pins?

No. You authenticate to Social Fetch with an API key. The route reads public search results; it does not act on behalf of a logged-in Pinterest user.