InsightSocial API
Pinterest

Pinterest URL Stats API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/pinterest/url-stats?urls=https%3A%2F%2Fwww.allrecipes.com%2Frecipe%2F10813%2Fbest-chocolate-chip-cookies%2F" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"

Step-by-step: Get Pinterest save counts for any URL

GET
/v1/pinterest/url-stats

Returns how many times each of up to 10 external URLs has been saved to Pinterest through the Save Button.

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Schema 2.

Use it to measure a page's pull on Pinterest, passing URLs exactly as used, since http vs https and a trailing slash count as different URLs.

10 credits per call.

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

urls*string

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.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/pinterest/url-stats?urls=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}