Pinterest

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. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/pinterest/board

Request

  • Base URL: https://api.scrapeatlas.com
  • URL: https://api.scrapeatlas.com/v1/pinterest/board
  • Auth: API key in header x-api-key

Query parameters

urlstring required

Required HTTPS pinterest.com or www.pinterest.com board URL (/<handle>/<slug>/). Board slugs accept ASCII letters, digits, underscores, hyphens and percent-escaped punctuation such as %2B. No credentials, explicit ports, short links, regional domains or encoded path segments. Tracking query parameters and fragments are removed.

cursorstring

Optional source bookmark returned by the previous response. Reuse with the same query, handle, or board. Null means end of results unless coverage warns pagination_unavailable. Source cursors can expire. Maximum 16,384 characters.

board_idstring

Optional numeric board id (board.id on every returned pin). With cursor, the continuation reads the board feed directly and still checks every pin against this id; without cursor the board is resolved as on the first page.

trim'true' | 'false'

Optional true or false (default false). True selects the documented compact fields; false preserves the public source record and nested extensions. Missing source fields remain absent.

number
OR
string

Earliest publication time to include, ISO 8601 or Unix seconds.

number
OR
string

Publication time to stop before, ISO 8601 or Unix seconds; later than since.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.