Get Pinterest save counts for any URL

See how many times up to 10 web pages have been saved to Pinterest through the Save button, in one call. 10 credits per call.

To see how many times a web page has been saved to Pinterest, call GET /v1/pinterest/url-stats with urls, a comma-separated list of 1 to 10 page URLs. It returns each URL with its save count, the number of times it was saved to Pinterest through the Save button. It costs 10 credits per call, whether you send one URL or 10.

Cost

10 credits per call of up to 10 URLs. Checking 100 pages takes 10 calls and costs 100 credits. Asking for the same URLs again within 6 hours is answered from the shared cache for 2 credits. Failed calls and empty results are free.

Which URL do I pass?

Pass the full address, starting with http:// or https://, exactly as people share it. The URLs go to Pinterest verbatim, and Pinterest counts each variant separately: http and https, with and without a trailing slash, and with and without a query string are different URLs with different counts. If you are not sure which form gets pinned, send the variants together in one call; they all fit in the same 10 credits.

Make the request

cURL

curl -G "https://api.insightsocial.app/v1/pinterest/url-stats" \
  --data-urlencode "urls=https://www.allrecipes.com/recipe/10813/best-chocolate-chip-cookies/" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

What comes back

A real response from 2026-10-14 for one URL.

Response

{
  "success": true,
  "endpoint": "/v1/pinterest/url-stats",
  "schema_version": "2",
  "data": {
    "items": [
      {
        "url": "https://www.allrecipes.com/recipe/10813/best-chocolate-chip-cookies/",
        "saves": 35108,
        "pinterest": {
          "url": "https://www.allrecipes.com/recipe/10813/best-chocolate-chip-cookies/",
          "count": 35108
        }
      }
    ],
    "total": 1
  },
  "pagination": { "next_cursor": null, "has_more": false, "page_size": 1 },
  "unavailable": [],
  "credits_used": 10
}

Field	What it holds
`data.items[].url`	The URL you sent.
`data.items[].saves`	How many times that exact URL has been saved to Pinterest through the Save button. 35,108 here.
`data.items[].pinterest`	The raw pair Pinterest returned: the URL it counted and its `count`.
`data.total`	How many URLs the response covers.

What are the limits?

10 URLs per call. Split longer lists into batches of 10. The endpoint does not paginate.
Exact URLs only. Each variant of a page has its own count. Add up the variants yourself if you want one number per page.
Save button saves. The count is what Pinterest reports for saves of the URL through its Save button. It says nothing about who saved it or when.
Absolute URLs. Each entry must start with http:// or https://.

What can I build with it?

Content audits. Rank a site's recipes, articles or product pages by Pinterest saves to see which ones travel on Pinterest.
Competitor benchmarking. Compare save counts for your pages and a competitor's pages on the same topic.
Tracking over time. Store the counts weekly for your key pages and watch which ones keep gaining saves.

GET /v1/pinterest/url-stats reference: every parameter and field.
GET /v1/pinterest/search: find the pins about a topic; include=engagement adds each pin's save count.
Pinterest endpoints: everything the API covers on Pinterest.