POST /v1/pinterest/pinPinterest Pin Scraper API
A single Pinterest pin by URL or ID: title, description, image/video, outbound link, engagement counts, board and pinner.
- Cost
- 1 credit
- Failed requests
- Refunded
- Cache hits
- Free
- Response fields
- 25
- Limits
- Public pins only
What the Pinterest Pin Scraper API does
The Pinterest Pin Scraper API returns a single public pin by URL or ID: title, description, alt text, dominant color, the largest image with its dimensions, video URL and duration for video pins, the outbound link and domain, creation date, the board it is saved to, the pinner and the full set of engagement counts: repins, reactions, comments, favorites and shares. Send a pin URL, a bare pin ID, or the ID as a string in id. Single pins carry more counts than feed and search results, so this is the call for measuring how one pin performs. No Pinterest developer account is needed. Each request costs 1 credit, failed requests are refunded and repeat reads within your cache window are free.
What you get
Top-level fields of the response. Every field is typed and documented; nullable fields are null when the platform does not show them.
| Field | Type | Description |
|---|---|---|
id | string | Pin ID |
link | string | https://www.pinterest.com/pin/<id>/ |
title | string | Pin title; empty string if none |
description | string | Pin description; empty string if none |
alt_text | string | null | Alt text (auto or user-provided) |
dominant_color | string | null | Dominant color hex |
image_url | string | null | Largest image URL (orig preferred) |
image_width | integer | null | Image width in pixels |
image_height | integer | null | Image height in pixels |
is_video | boolean | Pin is a video |
video_url | string | null | Highest-resolution video URL |
video_duration_ms | integer | null | Video duration in milliseconds |
repin_count | integer | null | Number of saves/repins |
reaction_count | integer | null | Sum of all reactions |
comment_count | integer | null | Number of comments |
favorite_count | integer | null | Number of favorites |
share_count | integer | null | Number of shares |
outbound_link | string | null | Destination URL of the pin |
outbound_domain | string | null | Destination domain |
created_at | string | null | Creation date string as given by Pinterest |
board_name | string | null | Board containing the pin |
board_url | string | null | Board URL on pinterest.com |
pinner_username | string | null | Pinner's username |
pinner_full_name | string | null | Pinner's display name |
pinner_image_url | string | null | Pinner's avatar URL |
Request example
Send the API key as a Bearer token. The body is a small JSON object.
curl -X POST https://api.scrapeeverything.com/v1/pinterest/pin \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.pinterest.com/pin/142567144449027286/"}'| Parameter | Required | Description |
|---|---|---|
url | No | Pin URL or a pin.it short share link (a bare pin ID also works). |
id | No | Numeric pin ID; used only when url is empty. |
What it costs
Each successful request costs 1 credit. Your first 100 credits are free. With credit packs, 1,000 requests to this endpoint cost:
Builder pack
$1.56
25,000 credits for $39.00
Growth pack
$1.19
100,000 credits for $119.00
Scale pack
$0.90
500,000 credits for $449.00
See pricing for all packs and rate limits.
Use cases
- Measure saves, reactions and shares of campaign pins for reporting.
- Find the destination website and board of pins your team collects.
- Enrich pins found through search or feeds with their full engagement counts.
Limitations: Unofficial API: not affiliated with or endorsed by the platform. Public data only, as a logged-out visitor sees it. Feeds and search return up to 50 pins per request; pins Pinterest hides from logged-out visitors are missing.
- Send id as a string.
Questions
Why send the ID as a string?
Pin IDs are large numbers, so send id as a string, or pass the pin URL.
Which counts are included?
repin_count, reaction_count, comment_count, favorite_count and share_count, when Pinterest shows them.
Does it return the destination link?
Yes. outbound_link is the pin's destination URL, and outbound_domain its domain.
How much does the Pinterest Pin Scraper API cost?
1 credit per successful request. Credits are bought in one-time packs and never expire. New accounts get 100 free credits. No payment details needed.
Am I charged for failed requests?
No. If the platform blocks the request, it times out or something fails on our side, the credits are refunded automatically. A definitive answer such as "this account does not exist" is billed because the lookup completed.
Can I re-read a result without paying again?
Yes. Send cache_days (1 to 14) and a repeat request for the same target within that window is served from your cache for free.
More Pinterest endpoints
Start with 100 free credits.
Continue with Google, create an API key and send your first request in under a minute.