Pinterest Pin API
Fetch one public Pinterest pin by URL or numeric pin id: title, description, image, video, outbound link and site, save count, hashtags, the pinner with their follower count, and the board it was saved to, as normalized JSON. A pin that does not exist is not charged.
Pricing
Pinterest Pin API pricing
Try it
Get Pinterest pin in one request
{
"data": {
"author": "Alex Rivera",
"authorFollowers": 12500,
"authorId": "Alex Rivera",
"authorName": "Alex Rivera",
"boardId": "a1b2c3d4",
"boardName": "Example title",
"boardUrl": "https://example.com/page",
"comments": 12500,
"createdUtc": 12.5,
"description": "A short example description of this item.",
"domain": "example.com",
"hashtags": [
"a1b2c3d4"
],
"id": "a1b2c3d4",
"image": "https://example.com/image.jpg",
"isVideo": true,
"likes": 12500,
"link": "https://example.com/page",
"saves": 42,
"title": "Example title",
"url": "https://example.com/page",
"videoUrl": "https://example.com/page"
},
"found": true,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-06 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- pinIdstring
Numeric Pinterest pin id, the number in the pin URL (https://www.pinterest.com/pin/<id>/), e.g. 101049585382283341. Pinterest Search returns it as id. Send this or url.
- urlstring
https://www.pinterest.com/pin/101049585382283341/
Full Pinterest pin URL carrying the numeric pin id, e.g. https://www.pinterest.com/pin/101049585382283341/. Country sites such as uk.pinterest.com or pinterest.de work too. pin.it short links are not accepted: open the link in a browser and send the pinterest.com/pin/... address it lands on. Send this or pinId.
Response
JSON, one example value per field.
The pin record, or null when no public pin has that id.
- authorstring
Username (handle) of the account that saved the pin. Populated whenever the provider has data for the entity.
- authorFollowersinteger
Follower count of the account that saved the pin. Populated whenever the provider has data for the entity.
- authorIdstring
Numeric Pinterest user id of the account that saved the pin.
- authorNamestring
Display name of the account that saved the pin.
- boardIdstring
Numeric id of the board the pin was saved to.
- boardNamestring
Name of the board the pin was saved to. Populated whenever the provider has data for the entity.
- boardUrlstring
URL of the board the pin was saved to.
- commentsinteger
Comment count, or null when the source does not report it.
- createdUtcnumber
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
- descriptionstring
Pin description text, or null when the pin has none.
- domainstring
Domain of the outbound link (e.g. tilebar.com), or null when the pin has no link.
- hashtagsstring[]
Hashtags on the pin.
- idstring
Numeric Pinterest pin id, as a string.
- imagestring
URL of the pin's original-size image; for a video pin, its cover image. Populated whenever the provider has data for the entity.
- isVideoboolean
True when the pin is a video.
- likesinteger
Reaction count, or null when the source does not report it.
- linkstring
The outbound website link the pin points to, or null when it has none.
- savesinteger
Number of times the pin has been saved (repinned). Populated whenever the provider has data for the entity.
- titlestring
Pin title, or null when the pin has none.
- urlstring
Canonical pin URL (https://www.pinterest.com/pin/<id>/).
- videoUrlstring
URL of the pin's video, or null when the pin is not a video.
- foundboolean
True when the pin exists and is public.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Pinterest Pin API
The AnyAPI Pinterest Pin API returns Pinterest pin data as normalized JSON from one POST call to /v1/run/pinterest.pin. Fetch one public Pinterest pin by URL or numeric pin id: title, description, image, video, outbound link and site, save count, hashtags, the pinner with their follower count, and the board it was saved to, as normalized JSON. A pin that does not exist is not charged. AnyAPI returns one normalized schema whichever source serves it. It costs from $0.85 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Pinterest pin calls through AnyAPI succeeded, with a median response time of 2.5 seconds across 2 measured calls.