Social Fetch
Pinterest

Search Pinterest pins

Search public Pinterest pins by keyword.

GET/v1/pinterest/search
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
query*stringquery

Search query text for Pinterest pins.

min 1 chars · max 512 chars

cursorstringoptionalquery

Opaque pagination cursor returned by a previous response.

min 1 chars

trimoptionalquery

When true, returns a smaller response with fewer fields.

Response fields
34

Endpoint-specific response payload.

dataquery
string

Search query that was evaluated for this response.

Matching Pinterest pins.

datapins[]id
string

Pinterest pin id.

min 1 chars

datapins[]url
stringnullable

Canonical public pin URL when available.

datapins[]title
stringnullable

Pin title when available.

datapins[]description
stringnullable

Pin description when available.

datapins[]link
stringnullable

Outbound destination link when available.

datapins[]domain
stringnullable

Destination domain when available.

datapins[]dominantColor
stringnullable

Dominant image color when available.

datapins[]createdAt
stringnullable

When the pin was created, when available.

Primary (original) image when available.

datapins[]imageurl
stringnullable

Image URL when available.

datapins[]imagewidth
integernullable

Width in pixels when available.

≥ 0

datapins[]imageheight
integernullable

Height in pixels when available.

≥ 0

User who pinned this item when available.

datapins[]pinnerid
stringnullable

Pinterest user id when available.

datapins[]pinnerusername
stringnullable

Pinterest username when available.

datapins[]pinnerfullName
stringnullable

Display name when available.

datapins[]pinneravatarUrl
stringnullable

Profile image URL when available.

Board this pin belongs to when available.

datapins[]boardid
stringnullable

Board id when available.

datapins[]boardname
stringnullable

Board name when available.

datapins[]boardurl
stringnullable

Canonical public board URL when available.

Engagement metrics when available.

datapins[]metricssaves
integernullable

Save count when available.

≥ 0

datapins[]metricsrepins
integernullable

Repin count when available.

≥ 0

Pagination state for the current response.

datapagenextCursor
stringnullable

Cursor to pass in the next request when more results are available.

datapagehasMore
boolean

Whether another page of results is available.

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

Code example

curl "https://api.socialfetch.dev/v1/pinterest/search?query=Italian Pot Roast" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Pin search results for the requested query.