Get Pinterest topic
Get a Pinterest topic by ideas URL, with its search count and narrower topics.
Headers
Get your API keyAPI key (`sfk_...`)
Link to the Pinterest ideas page of the topic, such as `https://www.pinterest.com/ideas/home-decor/935249274030/`.
min 1 chars · max 4096 chars
Endpoint-specific response payload.
Whether the Pinterest topic was found.
one of: found, not_found
Topic details when found.
Pinterest topic id.
min 1 chars
Topic name.
Pinterest ideas URL of the topic.
Pinterest's own search count for the topic. Pinterest does not say over what period, so read it as relative interest, not monthly searches or people.
≥ 0
When Pinterest last updated the topic (ISO-8601 UTC).
Narrower topics shown as chips on the ideas page. Empty when there are none; null when Pinterest did not provide them.
Chip label shown on the ideas page, such as `Diy`.
Full name of the narrower topic, such as `Diy Home Decor`.
Pinterest ideas URL of the narrower topic.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/pinterest/topics?url=https://www.pinterest.com/ideas/home-decor/935249274030/" \
-H "x-api-key: YOUR_API_KEY"Responses
Pinterest topic.