InsightSocial APIPinterest API reference: 6 endpoints for pins, boards, user boards, trends and search. Per-endpoint credit prices and cURL examples.
Pins, boards, user boards, trends and search.
New to the API? Read the Pinterest scraper API overview for what it returns and how it compares with the official API.
Base path: /v1/pinterest/...
Quickstart
curl "https://api.insightsocial.app/v1/pinterest/pin?url=https%3A%2F%2Fwww.pinterest.com%2Fpin%2F211174978421744%2F" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
2 of these are metered: the price depends on how much the call reads. See Credits.
2 are beta: they return the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp) rather than a schema-2 entity, and their fields may change. See Schema 2.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/search | 10–260 | Returns Pinterest pins matching a keyword, each with its text, original image, pinner and pin date; include=engagement adds save, reaction, comment and share counts. | query |
/pin | 10 | Returns one Pinterest pin: its text, original image, pinner, pin date, and its save, reaction, comment and share counts. | url |
/url-stats | 10 | Returns how many times each of up to 10 external URLs has been saved to Pinterest through the Save Button. Beta. | urls |
/board | 10–160 | Returns the pins on a Pinterest board with text, image URL, author, and save, comment and share counts; include=engagement adds each pin's date and reaction count. | url |
/user/boards | 10 | Returns the boards a Pinterest user has created, each with its title, description, pin count, and cover image. | handle |
/trends | 100 | Returns the Pinterest Trends list for one country: ranked search terms with a relative search index, for growing, seasonal, monthly or yearly tables. Beta. | — |