Pinterest hub

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/topics

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.