# Pinterest Url Stats API (https://www.socialcrawl.dev/platforms/pinterest/url-stats)

> Returns how many times each URL (up to 10 per request, comma-separated) has been saved to Pinterest via the Save Button. Counts are exact-URL-string keyed: scheme, trailing slash, and query string each produce a different count — URLs are passed through verbatim, never normalized. A count of 0 can mean either 'never pinned' or 'page does not exist'. Counts come from the Pinterest Save Button embed ecosystem; pages outside it may undercount. Single page only — no pagination.

TL;DR: `GET /v1/pinterest/url-stats` 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 |
| --- | --- | --- |
| `urls` | yes | Comma-separated list of 1–10 absolute http(s):// URLs, passed to Pinterest verbatim. Variants (https vs http, with/without trailing slash, with/without query string) are counted as different URLs. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/pinterest/url-stats?urls=https%3A%2F%2Fwww.allrecipes.com%2Frecipe%2F10813%2Fbest-chocolate-chip-cookies%2F" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get a URL's Pinterest save count with an API?

Send a GET request to /v1/pinterest/url-stats with up to 10 comma-separated URLs in the urls parameter. SocialCrawl returns the Pinterest Save-Button count for each URL, in the order you sent them.

### How many URLs can I check in one request?

Up to 10 absolute http(s) URLs per call, comma-separated. Each URL returns its own save count, and the whole request costs 1 credit no matter how many URLs you include — there's no pagination, it's a single batch.

### Why do two versions of the same URL return different counts?

Pinterest counts saves per exact URL string. https vs http, a trailing slash, or a query string each count as a separate URL, so pass each link exactly as it was pinned — SocialCrawl never rewrites or normalizes your URLs.

### What does a Pinterest save count of 0 mean?

Zero means the exact URL has no Save-Button saves on Pinterest. That can mean the page was never pinned or that the page doesn't exist — the count alone can't tell those two cases apart.

### How much does the Pinterest Save Count API cost?

One credit per request on the standard tier, whether you check 1 URL or all 10. New accounts get 100 free credits with no credit card required — enough for 100 batches before you pay 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 get a page's Pinterest save count with an API
- What does the SocialCrawl Pinterest url-stats endpoint return?