pinterest/
topic

The Pinterest Topic API looks up Pinterest topics from idea page URLs, returning each topic's name, the monthly search count Pinterest reports, refresh time and suggested narrower topics.

Pinterest Topic API

Idea page URL input
Monthly search count
Related topics with links
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Pinterest Topic

A Pinterest topic is an idea page that groups pins around a theme such as home decor, labelled with the number of monthly searches Pinterest reports for it, the date that figure was refreshed and a set of narrower topics like Christmas or Thrifted variations. Those figures show how much demand a theme carries on Pinterest, while the narrower topics point to the styles, occasions and materials people pair with it, which is the groundwork for keyword research and content planning.

Pinterest Topic API Features

  • Monthly search count per topicsearch_count is the number of monthly searches Pinterest reports for the topic, a direct measure of how often people look for it.
  • Narrower topics with their own linksrelated_topics lists the sub-topics Pinterest suggests, each with a full name, a short label such as DIY and the url of its idea page.
  • Refresh time for the figureupdated_at records when Pinterest last refreshed the topic, so you know how current the search count is.
  • Many topics in one requestThe Pinterest Topic API takes several idea pages at once in urls, and each returns exactly one row, keyed by the topic id in the page address.

Pinterest Topic API Parameters

ParametersRequiredDescription
urlsRequiredPinterest idea page links in the /ideas/{topic}/{id}/ form, including the numeric id, such as https://www.pinterest.com/ideas/home-decor/935249274030/.

How to Use the Pinterest Topic API

Submit idea page links to the Pinterest Topic API and receive one row per topic.

  1. Copy the idea page links from Pinterest and POST them in urls to /v1/pinterest/topic.
  2. Poll GET /v1/tasks/{task_id} until status reads succeeded.
  3. Read one topic per item in results.items; if has_more is true, fetch the rest with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/ideas/home-decor/935249274030/"]}'

# One row and 0.5 credits per topic.

Pinterest Topic API Use Cases

  • Ranking content ideas by demand: Use search_count as a Pinterest keyword tool: collect it for a list of candidate topics and work on the ones people search for most before planning pins or boards.
  • Finding long-tail angles inside a broad theme: Read the labels in related_topics, such as Christmas, Thrifted or Earthy Cottage under home decor, to choose a narrower angle with a clear audience.
  • Keeping your own Pinterest demand history: Collect the same topics every month with the Pinterest Topic API and store search_count with updated_at to chart how interest in each theme moves over time.

Pinterest Topic API Pro Tips

  • Keep the numeric id in every link you send to the Pinterest Topic API: /ideas/home-decor/935249274030/ is accepted, while an address ending at the topic name fails validation.
  • Expand a niche level by level by submitting related_topics[].url as the next batch, and drop topic ids you have already collected, since branches often lead back to the same idea pages.
  • Compare search_count across topics only alongside updated_at, because each figure dates from that topic's own last refresh.

Beyond the Pinterest Topic API, use these APIs when you need a different type of public Pinterest data.

  • Pinterest Pins API — Resolve public Pin URLs into normalized content, creator, media, taxonomy, timestamps, and visible metrics.
  • Pinterest User Pins API — Discover public Pins from profile URLs with a per-profile limit, normalized content, creator, media, timestamps, and visible metrics.
  • Pinterest Profiles API — Collect public profile identity, bio, image, website, visible account counts, and collection context from profile URLs.
  • Pinterest Search API — Search public Pins by text query with a result limit, returning normalized content, creator, media, taxonomy, timestamps, and visible metrics.
  • Pinterest User Boards API — List the boards on Pinterest profiles from profile URLs, with names, descriptions, covers, creation dates and pin, follower, section and collaborator counts.
  • Pinterest Board Pins API — Collect the pins on a Pinterest board from its board URL in board order, with pin text, the saving account, full-size images and pin links.

Explore other platforms

Combine Pinterest data with public data from other supported social platforms.

Pinterest Topic API — FAQ

Pinterest Topic API is a programmatic interface for reading Pinterest topics from the URLs of their idea pages. It returns each topic's name, the monthly search count Pinterest reports, the time that count was last refreshed and the narrower topics suggested under it.

It gives the current monthly search count Pinterest reports for each topic, together with the time it was refreshed. Collecting the same topics on a schedule builds a history you can chart yourself.

Idea pages live under pinterest.com/ideas/ and end with a numeric id, as in /ideas/home-decor/935249274030/. Every row also returns related_topics[].url, which is already in the accepted form.

name is the full topic, such as Christmas Home Decor, and label is the short tag Pinterest shows for it, such as Christmas.

The Pinterest Topic API charges 0.5 credits for each topic returned, so checking ten idea pages costs 5 credits.