> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/pinterest/topics>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/pinterest/topics.mdx>

---

# 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` 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`.

## Request

- **Endpoint:** `GET /v1/pinterest/topics`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by ideas URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/pinterest/topics/get)
- **Platform page:** [/platforms/pinterest](https://www.socialfetch.dev/platforms/pinterest)

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