# Pinterest Pin API (https://www.socialcrawl.dev/platforms/pinterest/pin)

> Returns one Pinterest pin: its text (the description, or the title when the description is empty), the original image and a thumbnail, the pinner's username, name and avatar, the save count, the reaction count, the comment count, the share count, and the date it was pinned. Many pins carry no text at all, so `post.content.text` can be null.

TL;DR: `GET /v1/pinterest/pin` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full URL of the Pinterest pin with its numeric id, e.g. `https://www.pinterest.com/pin/1142999580460050856/`. An encrypted `/pin/e1_...` link, the form search and board pages return as of 19/10/2026, cannot be read and answers 404 at 0 credits. |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/pinterest/pin" \
  --data-urlencode "url=https://www.pinterest.com/pin/1142999580460050856/" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a Pinterest pin's details with an API?

Send a GET request to /v1/pinterest/pin with the full pin URL in the url parameter. SocialCrawl returns the pin's text, image URL, save count, reaction and comment counts, author, and the date it was created.

### What fields does GET /v1/pinterest/pin return?

The response includes pin id, permalink, text (the title, or the description when the title is empty), image URLs at multiple resolutions, save count, reaction count, comment count, share count, author info, and the created timestamp, all in a unified schema.

### Does the endpoint return video pins?

Yes. Video pins return the same core fields plus video URL, thumbnail, and playback metadata. Everything lives under the same content.media structure used by TikTok, Instagram, and YouTube endpoints.

### Can I trim the Pinterest pin response?

Yes. Pass trim=true and the endpoint returns a compact payload with only the essential fields. Useful for embedding Pinterest pins at scale or building lean dashboards that display a pin summary.

### How much does the Pinterest Pin API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, enough to pull around 100 Pinterest pin records before paying anything.

See the full Pinterest API: https://www.socialcrawl.dev/platforms/pinterest

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to fetch a Pinterest pin's details with an API
- What does the SocialCrawl Pinterest Pin API return?