Pinterest

Pinterest Search API

Keyword pin search — offset cursor, SERP window 40.

Search public Pinterest pins by keyword (logged-out Pinterest search is empty, so results come from a public search-results window of pin pages, each hydrated). Cursor pagination via nextCursor + hasMore; a null nextCursor means the end of the SERP window (max 40). Envelope: requested / listingHits / truncatedReason=serp-window. timings{serpMs,hydrateMs,enrichMs,totalMs} show which stage burned the seconds — search is the slow endpoint in this block. ~0.5 credits/result.

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

get/v1/pinterest/search

Request

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

Query parameters

qstring required

Keywords or search query (min 2 characters).

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 SERP window (max 40).

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.