Skip to main content
POST
Pinterest Board Pins API

Pinterest Board Pins

Get the pins inside a Pinterest board, in the order the board shows them. Each pin includes its title or description, the account that saved it, the full-size image and its pin URL. Point it at a curated board in your niche to collect reference images, track what a competitor keeps adding to a seasonal board, or build a mood board dataset in one pass.
Provide Pinterest board URLs in urls, using ///. results_limit applies to each board, defaults to 50 and accepts integers from 1 to 1000. Pins come back in the order the board shows them, and each pin returned 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 board URLs in urls, using /{username}/{board}/. results_limit applies to each board, defaults to 50 and accepts integers from 1 to 1000. Pins come back in the order the board shows them.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:50
Required range: 1 <= x <= 1000

Response

Task accepted

code
integer
data
object