Pinterest Topic API
Pass a Pinterest ideas URL and get the topic's search count and its narrower topics, for keyword and trend research.
GET /v1/pinterest/topics1 credit Failed requests are free
About this endpoint
GET /v1/pinterest/topics takes the url of a Pinterest ideas page, such as https://www.pinterest.com/ideas/home-decor/935249274030/. On a completed 200 response, branch on data.lookupStatus: found or not_found. When found, data.topic holds id, name, url, searchCount, updatedAt and refinements, the narrower topics shown as chips on the page, each with its own ideas URL.
searchCount is Pinterest's own count; Pinterest does not say over what period, so compare topics with it rather than reading it as monthly searches. Pins for a keyword are GET /v1/pinterest/search.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Pinterest Topic API FAQ
What does the Pinterest Topic API return?
The topic's id, name and URL, Pinterest's search count for it, when Pinterest last updated it, and the narrower topics it suggests.
Is searchCount monthly search volume?
No. It is Pinterest's own count and Pinterest does not say what period it covers. Use it to compare topics with each other.
Which URLs does it accept?
Pinterest ideas pages, pinterest.com/ideas/<topic>/<id>/, on any Pinterest domain. Pin, board and profile links are rejected with a 400.
How much does the Pinterest Topic API 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.