Pinterest

Get Pinterest topic

Get a Pinterest topic by ideas URL, with its search count and narrower topics.

GET/v1/pinterest/topics
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
urlstringrequiredquery

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

Response fields
18

Endpoint-specific response payload.

datalookupStatus
string

Whether the Pinterest topic was found.

one of: found, not_found

Topic details when found.

datatopicid
string

Pinterest topic id.

min 1 chars

datatopicname
string

Topic name.

datatopicurl
string

Pinterest ideas URL of the topic.

datatopicsearchCount
integernullable

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

datatopicupdatedAt
stringnullable

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.

datatopicrefinements[]label
string

Chip label shown on the ideas page, such as `Diy`.

datatopicrefinements[]name
string

Full name of the narrower topic, such as `Diy Home Decor`.

datatopicrefinements[]url
string

Pinterest ideas URL of the narrower topic.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.