API Reference
Use Crawlora's Pinterest API endpoints to extract supported public Pinterest data as structured JSON. This documentation covers 8 active endpoints including Get a Pinterest board's detail, Get Pinterest's "Ideas" category list, Get a Pinterest "Ideas" category's detail feed, Get a Pinterest pin's full detail, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as username, slug, id, query, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/pinterest/search?query=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/pinterest/board/{username}/{slug}apiKey3 credits/requestReturns a Pinterest board's metadata (name, description, cover image, pin/follower counts, owner) plus a page of pins from that board. Public data sourced from Pinterest's own board pages.
Required params: username:path, slug:path
/pinterest/categoriesapiKey1 credit/requestReturns Pinterest's top-level "Ideas" category taxonomy (e.g. "Animals", "Home Decor", "Food And Drink"). Each entry's id is usable directly with GET /pinterest/ideas/{id}. Public data sourced from Pinterest's own ideas.pinterest.com-style category hub.
Required params: None
/pinterest/ideas/{id}apiKey3 credits/requestReturns one "Ideas" category's metadata (name, description, follower count) plus a page of pins from that category's feed. Public data sourced from Pinterest's own ideas category pages.
Required params: id:path
/pinterest/pin/{id}apiKey1 credit/requestReturns a single Pinterest pin's full detail: title, description, image, board, pinner, comment count, save count, and creation time. Public data sourced from Pinterest's own pin pages.
Required params: id:path
/pinterest/searchapiKey3 credits/requestReturns public Pinterest pins matching a text query: title, description, image, board, and pinner for each result. Public data sourced from Pinterest's own web search.
Required params: query:query
/pinterest/user/{username}apiKey1 credit/requestReturns a Pinterest user's public profile: display name, bio, website, avatar, and follower/following/pin/board counts. Public data sourced from Pinterest's own profile pages.
Required params: username:path
/pinterest/user/{username}/boardsapiKey3 credits/requestReturns a page of a Pinterest user's own boards: name, description, cover image, and pin/follower counts for each. Public data sourced from Pinterest's own profile pages.
Required params: username:path
/pinterest/user/{username}/pinsapiKey3 credits/requestReturns a page of a Pinterest user's own pins: title, description, image, board, and pinner for each. Public data sourced from Pinterest's own profile pages.
Required params: username:path
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get a Pinterest board's detail | /pinterest/board/{username}/{slug} | GET | 3 credits/request | username:path, slug:path | View docs | Try endpoint |
| Get Pinterest's "Ideas" category list | /pinterest/categories | GET | 1 credit/request | None | View docs | Try endpoint |
| Get a Pinterest "Ideas" category's detail feed | /pinterest/ideas/{id} | GET | 3 credits/request | id:path | View docs | Try endpoint |
| Get a Pinterest pin's full detail | /pinterest/pin/{id} | GET | 1 credit/request | id:path | View docs | Try endpoint |
| Search Pinterest pins | /pinterest/search | GET | 3 credits/request | query:query | View docs | Try endpoint |
| Get a Pinterest user's public profile | /pinterest/user/{username} | GET | 1 credit/request | username:path | View docs | Try endpoint |
| Get a Pinterest user's boards | /pinterest/user/{username}/boards | GET | 3 credits/request | username:path | View docs | Try endpoint |
| Get a Pinterest user's own pins | /pinterest/user/{username}/pins | GET | 3 credits/request | username:path | View docs | Try endpoint |