Social Fetch
Pinterest

Get Pinterest pin

Fetch a public Pinterest pin by URL.

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

API key (`sfk_...`)

Parameters
2
url*stringquery

Link to the Pinterest pin.

min 1 chars · max 4096 chars

trimoptionalquery

When true, returns a smaller response with fewer fields.

Response fields
59

Endpoint-specific response payload.

datalookupStatus
string

Whether the pin was found.

one of: found, not_found

Pin details when found.

datapinid
string

Pinterest pin id.

min 1 chars

datapinurl
stringnullable

Canonical public pin URL when available.

datapintitle
stringnullable

Pin title when available.

datapindescription
stringnullable

Pin description when available.

datapinaltText
stringnullable

Accessibility alt text when available.

datapinlink
stringnullable

Outbound destination link when available.

datapindomain
stringnullable

Destination domain when available.

datapindominantColor
stringnullable

Dominant image color when available.

datapincreatedAt
stringnullable

When the pin was created, when available.

Image renditions when available.

Original image when available.

datapinimagesorigurl
stringnullable

Image URL when available.

datapinimagesorigwidth
integernullable

Width in pixels when available.

≥ 0

datapinimagesorigheight
integernullable

Height in pixels when available.

≥ 0

236px-wide image when available.

datapinimagessize236url
stringnullable

Image URL when available.

datapinimagessize236width
integernullable

Width in pixels when available.

≥ 0

datapinimagessize236height
integernullable

Height in pixels when available.

≥ 0

474px-wide image when available.

datapinimagessize474url
stringnullable

Image URL when available.

datapinimagessize474width
integernullable

Width in pixels when available.

≥ 0

datapinimagessize474height
integernullable

Height in pixels when available.

≥ 0

564px-wide image when available.

datapinimagessize564url
stringnullable

Image URL when available.

datapinimagessize564width
integernullable

Width in pixels when available.

≥ 0

datapinimagessize564height
integernullable

Height in pixels when available.

≥ 0

736px-wide image when available.

datapinimagessize736url
stringnullable

Image URL when available.

datapinimagessize736width
integernullable

Width in pixels when available.

≥ 0

datapinimagessize736height
integernullable

Height in pixels when available.

≥ 0

User who pinned this item when available.

datapinpinnerid
stringnullable

Pinterest user id when available.

datapinpinnerusername
stringnullable

Pinterest username when available.

datapinpinnerfullName
stringnullable

Display name when available.

datapinpinneravatarUrl
stringnullable

Profile image URL when available.

Original creator when available.

datapinoriginPinnerid
stringnullable

Pinterest user id when available.

datapinoriginPinnerusername
stringnullable

Pinterest username when available.

datapinoriginPinnerfullName
stringnullable

Display name when available.

datapinoriginPinneravatarUrl
stringnullable

Profile image URL when available.

Board this pin belongs to when available.

datapinboardid
stringnullable

Board id when available.

datapinboardname
stringnullable

Board name when available.

datapinboardurl
stringnullable

Canonical public board URL when available.

Visual annotation labels when available.

datapinvisualAnnotations[]
stringoptional

Engagement metrics when available.

datapinmetricssaves
integernullable

Save count when available.

≥ 0

datapinmetricscomments
integernullable

Comment count when available.

≥ 0

datapinmetricsreactions
integernullable

Reaction count when available.

≥ 0

datapinmetricsrepins
integernullable

Repin count when available.

≥ 0

datapinmetricsshares
integernullable

Share count when available.

≥ 0

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/pins?url=https://www.pinterest.com/pin/1124351863225567517/" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Pin lookup result.