Pinterest

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

get/v1/pinterest/search

Request

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

Query parameters

querystring required

Required keyword, 1–500 characters after trimming.

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.

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.