Url Stats
Returns how many times each of up to 10 external URLs has been saved to Pinterest through the Save Button.
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.
20 credits per call.
Re-running the exact same call within 6h is free.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
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.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/pinterest/url-stats?urls=string"{ "success": true, "platform": "instagram", "endpoint": "/v1/instagram/profile/posts", "data": { "items": [ "…" ], "dropped": 0 }, "pagination": { "next_cursor": "is2.eyJwIjoyfQ", "has_more": true, "page_size": 12 }, "credits_used": 20, "credits_remaining": 9980, "request_id": "req_1a2b3c4d5e6f", "cached": false, "idempotent_replay": false, "charge_reason": "miss", "free_call": false}Trends GET
Returns the Pinterest Trends list for one country: ranked search terms with a relative search index, for growing, seasonal, monthly or yearly tables. Use it when you want what a market is searching for on Pinterest right now, with no keyword to start from. **200 credits** per call. Re-running the exact same call within 6h is free.
User › Boards GET
Returns the boards a Pinterest user has created, each with its title, description, pin count, and cover image. Use it to list someone's boards from their handle, then pass a board URL to board to get that board's pins. **20 credits** per call. Re-running the exact same call within 24h is free.