Skip to content
scrapeatlas.Dashboard

Visual discovery

Pinterest API

Search pins, boards, users and suggestions, retrieve pins, related pins, profiles, user pins, boards and board pins, and count URL saves.

13 endpointsx-api-key

Discover Pinterest pins, boards and accounts, retrieve pin, profile and board details, follow pagination, choose full or compact records and measure how often pages are saved.

API availability: Available

Base URL · local workerhttp://localhost:3014Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/pinterest/search

Search Pinterest pins

Discover public pins for a keyword. Retrieves one page with a requested page size of 25; Pinterest controls the actual result count and ranking. Pass cursor to continue. Full records retain available image, destination, board, author, counter and media fields. Trimmed pins contain id, url, description, created_at, pinner and images when supplied.

Reference
GET/v1/pinterest/search/boards

Search Pinterest boards

Discover public boards for a keyword with names, descriptions, owners, pin and follower counts, cover images and thumbnails. Pinterest controls ranking and page size; pass cursor to continue. Trimmed boards contain id, url, description, follower_count, pin_count, name, image_cover_hd_url and created_at when supplied.

Reference
GET/v1/pinterest/search/users

Search Pinterest users

Find public Pinterest accounts for a keyword with usernames, display names, avatars, follower, pin and board counts, verification and recent pin thumbnails. Pass cursor to continue. Trimmed users contain id, username, url, full_name, image_medium_url, follower_count, pin_count, board_count and verified_identity when supplied.

Reference
GET/v1/pinterest/search/suggestions

Get search suggestions

Autocomplete a partial keyword with Pinterest’s own search suggestions: suggested queries with their search links, plus suggested accounts where Pinterest includes them. Suggestions keep Pinterest’s order and source fields.

Reference
GET/v1/pinterest/pin

Get a Pinterest pin

Retrieve a public pin’s full details: description, media, author, board, destination, save, share and reaction counts. Full responses expose Pinterest’s camelCase fields at the top level, preserving nested media and author data. imageSpec_orig aliases images_orig when needed. Trimmed fields: entityId, seoAltText, originPinner, pinner, imageSpec_orig, description, shareCount, nativeCreator, createdAt, repinCount and totalReactionCount. Counts are never guessed; missing required pin fields fail explicitly.

Reference
GET/v1/pinterest/pin/metadata

Get pin metadata

Retrieve a public pin’s metadata, including its description, images, media, destination, author, board and engagement fields. The pin object preserves Pinterest’s source field names and nested attributes.

Reference
GET/v1/pinterest/pin/related

Get related pins

Retrieve the pins Pinterest recommends alongside a public pin (“More like this”) with images, titles, descriptions, destinations, authors, boards and counters. Pass cursor to continue. Trimmed pins contain id, url, description, created_at, pinner and images when supplied.

Reference
GET/v1/pinterest/profile

Get a Pinterest profile

Retrieve a public Pinterest profile by username: display name, bio, avatar images, website, follower, following, pin and board counts, monthly profile views, verification and account flags. Source field names and nulls are preserved.

Reference
GET/v1/pinterest/user/boards

Get a user’s boards

List a page of public boards with counts, creation dates, cover images and cursor pagination. Use trim for compact records with identifiers, URLs, descriptions, counts, cover images and timestamps.

Reference
GET/v1/pinterest/user/pins

Get a user’s pins

List a page of the public pins a user has saved, newest first, with images, titles, descriptions, destinations, boards and counters. Pass cursor to continue. Trimmed pins contain id, url, description, created_at, pinner and images when supplied.

Reference
GET/v1/pinterest/board

Get pins from a board

Retrieve a page of pins from a public board, including the board information, destinations, rich summaries, annotations and reaction counts attached to each pin. Pass cursor and an optional board_id for the next page. Trimmed pins keep id, url, description, created_at, pinner, images, title, link, domain, alt_text, unified_user_note, board, rich_summary and reaction_counts when supplied.

Reference
GET/v1/pinterest/board/metadata

Get board metadata

Retrieve a public board’s details without its pins: name, description, owner, pin, follower, section and collaborator counts, cover images, category and SEO attributes. Source field names and nulls are preserved.

Reference
GET/v1/pinterest/url-stats

Get URL save counts

Count how many times web pages have been saved to Pinterest. Pass up to ten comma-separated addresses; each address is counted exactly as written, so http/https, trailing slashes and query strings are separate entries. A count of 0 means Pinterest reports no saves for that exact address.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/pinterest/search?query=synthetic+recipes" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • Four concurrent operations; one 20-second deadline per operation.
  • At most four upstream HTTP attempts, including one shared transient retry. Pins use two small public GraphQL reads (the pin page only when those are unavailable); board pins use two requests on the first page and one when a continuation carries board_id; URL save counts use one request per address (up to ten, four at a time); other operations use one.
  • At most 4 MiB of combined decoded successful response data, JSON depth 24 and 40,000 parsed JSON nodes.
  • Lists request 25 records per page and return up to 100, one cursor page per request.
  • Logged-out HTTPS to www.pinterest.com and widgets.pinterest.com only. No Pinterest account or session, browser execution, media download or destination visits.
  • Dedicated PINTEREST_API_KEY in x-api-key. Process health confirms local readiness, not upstream availability.
  • No result retention or shared database; every response is fetched live.
  • Collection completeness describes the returned page. Optional source fields Pinterest omits stay absent; source ordering and null values are retained.
Error codes
12
HTTPfailure.codeMeaning
200partialSome records were restricted, malformed or capped, or pagination was unavailable. Inspect coverage.warnings.
400invalid_requestMissing, duplicate, unsupported or invalid parameters or URL.
401unauthorizedMissing or invalid service key.
403restricted_pageAccess-gated pin, board or profile, or no usable public records.
404not_foundPinterest explicitly reported a missing resource, or the route is unknown.
429upstream_rate_limitedPinterest rate limited retrieval.
502upstream_challengedPinterest challenged the request.
502unsupported_page upstream_errorIncomplete, changed or mismatched source data, or retrieval failure.
502response_too_large payload_too_complex request_limitA byte, parsing or request bound was exceeded.
502unsafe_redirectUpstream redirected; redirects are not followed.
503busyAll worker slots are occupied.
504timeoutThe shared deadline expired.