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/search1 credit per successful request.
About this endpoint
Commerce and lifestyle teams treat Pinterest as a product-discovery surface, not a social feed. If you only scrape Instagram or TikTok, you miss pin titles, image URLs, and board context that shoppers already use to shortlist SKUs. Hand-copying search results does not scale, and a Pinterest-only HTML parser is another scraper to babysit next to the rest of your social warehouse.
`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.
Pinterest Search API 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.