Pinterest

Pinterest Board API

Pins on a Pinterest board — saves, imageOriginal, destinationUrl, top-level author.

Pass a Pinterest board URL (.../username/board-name/ — not a /pin/ URL) and get that board's public pins as clean JSON. Response includes board + boardName, a top-level author{} (pinner card with followers, once), and pins[] with id/url, title when Pinterest exposes it, description, link (outbound URL — no destinationUrl twin), domain, saves, image + imageOriginal + images{236x,564x,originals,…}, and a slim per-pin author{username,displayName}. Cursor pagination via nextCursor + hasMore; a null nextCursor means the end of the pidgets window (~100). Envelope: requested / listingHits / truncatedReason=pidgets-window. ~0.5 credits/pin (min 2).

Docs: https://captapi.com/apis/pinterest-board

get/v1/pinterest/board

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/pinterest/board
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

urlstring required

Pinterest board URL (.../username/board-name/), not a /pin/ URL. Example: https://www.pinterest.com/potterybarn/rustic-lodge-lookbook/. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.

limitinteger

Max items to return (default 25, max 200). Billed per result.

cursorstring

Pagination cursor. Leave empty for the first page; then pass the nextCursor value returned in the previous response (numeric offset, e.g. 25). A null nextCursor means the end of the retrievable window (pidgets ~100).

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.