Skip to main content
POST
Pinterest Topic API

Pinterest Topic

Size up a Pinterest topic before you build content for it. For each idea page you get the monthly search count Pinterest reports and the narrower topics it suggests underneath, such as the styles, occasions and materials people combine with the main idea. It works as keyword research for Pinterest: compare demand across topics, find long-tail angles, and plan boards around what people actually search for.
Provide Pinterest idea page URLs in urls, using /ideas///. Each topic returns one row with its monthly search count and narrower topics, and each row costs 0.5 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide Pinterest idea page URLs in urls, using /ideas/{topic}/{id}/. Each topic returns one row with its monthly search count and the narrower topics Pinterest suggests under it.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object