Pinterest Search Scraper

The Actor searches public Pinterest Pins by query and saves matching Pin records. scope selects standard Pins or video Pins; each record can contain id, title, description, dominant_color, image_url, board, pinner, domain, and link when supplied.

{
  "query": "coffee",
  "scope": "pins",
  "maxItems": 100
}

Search controls

• query is required and accepts the words or phrase to search.
• scope defaults to pins; use videos to search video Pins.
• maxItems defaults to 50. A value of 0 removes the result limit.
• addonPinDetails defaults to false. Turn it on to fetch full Pin detail for each search result — save counts, comment totals, and the complete media record under pin_details. Search results do not carry save counts on their own, so this is the option to enable when ranking results by popularity. It costs one extra request per Pin and is billed per enriched row, so leave it off for a fast, cheap keyword scan.
• addonPinnerProfile defaults to false. Turn it on to fetch the full public profile of the account that saved each search result, attached under pinner_profile. It costs one extra request per Pin and is billed per enriched row.

Example dataset item

{
  "id": "873135446527329879",
  "dominant_color": "#74644e",
  "domain": "Uploaded by user",
  "board": {
    "id": "873135515196321762",
    "name": "My own stuff😌😌",
    "url": "/asmaahadi2003/my-own-stuff/"
  },
  "image_url": "https://i.pinimg.com/originals/51/9f/13/519f131c4c945c6854e83e9937664e9b.jpg"
}

This is a live-verified coffee search result. Its source title and description were empty, so neither is included in the example.

Result boundaries

Pagination continues until maxItems is reached, the source returns an empty page, or no further page is available. The dataset can therefore contain fewer records than maxItems; setting the limit does not guarantee that the search has that many matches. Promotional and editorial modules returned alongside genuine Pins are excluded, so they never consume a result row.

The Pinterest Pin Scraper is the appropriate follow-up when a search result id needs its single-Pin detail record. The Pinterest Boards Scraper lists boards for a known profile instead of searching Pins.