Pinterest Board Search Scraper

Find public Pinterest boards by keyword and export each matching collection as a separate row. Pinterest Board Search Scraper returns names, descriptions, URLs, covers, pin counts and available owner and section metadata.

Start with a topic to discover curated collections, review their scope and select useful boards for a later pin export.

At a glance	Details
📥 Input	Enter keyword queries or canonical Pinterest /search/boards/?q= URLs.
📤 Output	One board per success row with the input source retained
📄 Pagination	Result pages per input; page sizes and availability are controlled by Pinterest
🔐 Login required	No
⚡ Processing	Up to 5 HTTP requests concurrently; up to 5 attempts for temporary failures
💾 Delivery	One Apify dataset view with individual records and complete nested JSON

What the Pinterest board search scraper collects 🔎

The Actor follows the public board-search results for each phrase. Each board keeps query context, while previews and owner details remain within that board record.

Data can include:

• Matching board IDs, names, descriptions and URLs
• Cover images and available preview metadata
• Pin and section counts when exposed
• Owner profiles and public board indicators
• Input query context for comparing search samples

How to collect board search results from Pinterest 🚀

1. Enter one or more supported inputs.
2. Set the page budget and any collection option you need.
3. Start the Actor.
4. Open the Boards dataset view and review success or failed rows.
5. Export the dataset or retrieve records from your application.

{
  "inputList": [
    "modern kitchen"
  ],
  "pagesPerSearch": 1
}

The page setting counts search-result pages per query. Pinterest controls page sizes and matching; the number of rows is not an exact-result limit.

Pinterest board search results output fields 📦

Field	Type	Meaning
input	string	Original submitted input.
status	string	Whether this entity was successfully collected.
page	integer or null	One-based page within this input's collection.
query	string or null	Resolved keyword query used for this result.
id	string or null	Id when supplied by Pinterest.
url	string or null	Url when supplied by Pinterest.
name	string or null	Name when supplied by Pinterest.
description	string or null	Description when supplied by Pinterest.
pin_count	integer or null	Pin count when supplied by Pinterest.
follower_count	integer or null	Follower count when supplied by Pinterest.
section_count	integer or null	Section count when supplied by Pinterest.
sectionless_pin_count	integer or null	Sectionless pin count when supplied by Pinterest.
collaborator_count	integer or null	Collaborator count when supplied by Pinterest.
is_collaborative	boolean or null	Is collaborative when supplied by Pinterest.
privacy	string or null	Privacy when supplied by Pinterest.
category	string or null	Category when supplied by Pinterest.
cover_image_url	string or null	Cover image url when supplied by Pinterest.
cover_image_hd_url	string or null	Cover image hd url when supplied by Pinterest.
last_modified_at	string or null	Last modified at when supplied by Pinterest.
owner	object or null	Owner when supplied by Pinterest.
images	array or null	Available image variants, preserved in one dataset cell.

Nested field structure:

• owner: id, username, name, url, image_url, image_large_url, is_verified, is_verified_merchant, is_private, follower_count.
• images[]: variant, url, width, height, dominant_color.

The examples below use normalized public response data. Values are snapshots and may change; every top-level output field is included. Different media variants and nested objects remain inside the same row.

Complete representative success result:

{
  "input": "modern kitchen",
  "status": "success",
  "page": 1,
  "query": "modern kitchen",
  "id": "810859176599804268",
  "url": "https://www.pinterest.com/nordiskakok/modern-kitchen-design/",
  "name": "Modern kitchen design",
  "description": "Discover the elegance of modern kitchen design — where clean lines, smart storage, and high-quality materials meet functional beauty. Explore contemporary layouts, minimalist aesthetics, and innovative solutions that transform your kitchen into a stylish, efficient space. From sleek cabinetry to cutting-edge appliances, get inspired to create a modern kitchen tailored to your lifestyle.",
  "pin_count": 133,
  "follower_count": null,
  "section_count": 0,
  "sectionless_pin_count": null,
  "collaborator_count": 0,
  "is_collaborative": false,
  "privacy": "public",
  "category": null,
  "cover_image_url": "https://i.pinimg.com/200x150/55/c8/b2/55c8b2e930cf48238db1dabd59c930d1.jpg",
  "cover_image_hd_url": "https://i.pinimg.com/474x/55/c8/b2/55c8b2e930cf48238db1dabd59c930d1.jpg",
  "last_modified_at": "2026-09-09T05:32:06Z",
  "owner": {
    "id": "810859245317711185",
    "username": "nordiskakok",
    "name": "Nordiska Kök - Scandinavian design kitchens",
    "url": "https://www.pinterest.com/nordiskakok/",
    "image_url": "https://i.pinimg.com/75x75_RS/8b/26/d9/8b26d9d9d7f0915ecf88714d0e7a16ca.jpg",
    "image_large_url": "https://i.pinimg.com/140x140_RS/8b/26/d9/8b26d9d9d7f0915ecf88714d0e7a16ca.jpg",
    "is_verified": true,
    "is_verified_merchant": false,
    "is_private": null,
    "follower_count": 49165
  },
  "images": [
    {
      "variant": "236x.0",
      "url": "https://i.pinimg.com/236x/84/7c/60/847c606164e749b8935b3063191bd537.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#978372"
    },
    {
      "variant": "236x.1",
      "url": "https://i.pinimg.com/236x/9a/f8/63/9af863e5bb1b2d35f5025af968fe7765.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#7B674E"
    },
    {
      "variant": "236x.2",
      "url": "https://i.pinimg.com/236x/39/3e/0d/393e0d1129deadac8a34ffe04f9560cf.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#846D53"
    },
    {
      "variant": "236x.3",
      "url": "https://i.pinimg.com/236x/c8/de/b9/c8deb963e706178cb739ff1fbf7a0bb5.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#B3A291"
    },
    {
      "variant": "236x.4",
      "url": "https://i.pinimg.com/236x/30/99/f9/3099f9284967ead7e75ea25b2661465d.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#A69C8C"
    },
    {
      "variant": "236x.5",
      "url": "https://i.pinimg.com/236x/5d/17/0f/5d170f918fb69d053d35dc40786e8db2.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#775C4B"
    },
    {
      "variant": "236x.6",
      "url": "https://i.pinimg.com/236x/28/cb/7b/28cb7b76f90079333fc02ba49ad006f4.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#BEB8A9"
    },
    {
      "variant": "236x.7",
      "url": "https://i.pinimg.com/236x/64/69/20/646920a2a12b4dfab66beea841c8ae80.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#9D8C76"
    },
    {
      "variant": "236x.8",
      "url": "https://i.pinimg.com/236x/16/31/09/163109e861ec3dfe01ca35e72082a0b6.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#B7AC95"
    },
    {
      "variant": "236x.9",
      "url": "https://i.pinimg.com/236x/ca/5b/8b/ca5b8bea5cc9a22948eac6d315e2dee0.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#B4AD9C"
    },
    {
      "variant": "236x.10",
      "url": "https://i.pinimg.com/236x/f2/ee/d9/f2eed950be3bd273077501dbc239a218.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#9F8C7D"
    },
    {
      "variant": "236x.11",
      "url": "https://i.pinimg.com/236x/78/af/fc/78affc1444ff601e4ed5bdafc9dfb4d0.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#BCB3AA"
    },
    {
      "variant": "236x.12",
      "url": "https://i.pinimg.com/236x/f8/4e/b9/f84eb991ae0068d6fd569a1010dc6ede.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#D0C9BA"
    },
    {
      "variant": "236x.13",
      "url": "https://i.pinimg.com/236x/76/57/b5/7657b5872f963bfd342a5f2c720a4c50.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#8A7B62"
    },
    {
      "variant": "236x.14",
      "url": "https://i.pinimg.com/236x/a0/c6/11/a0c611e61b1f5d708c3215b54aef46a3.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": "#B3AE9E"
    }
  ]
}

Complete failed dataset item:

{
  "input": "invalid input",
  "status": "failed",
  "page": null,
  "query": null,
  "id": null,
  "url": null,
  "name": null,
  "description": null,
  "pin_count": null,
  "follower_count": null,
  "section_count": null,
  "sectionless_pin_count": null,
  "collaborator_count": null,
  "is_collaborative": null,
  "privacy": null,
  "category": null,
  "cover_image_url": null,
  "cover_image_hd_url": null,
  "last_modified_at": null,
  "owner": null,
  "images": null
}

A failed row preserves input, sets status to failed, and sets every other top-level field to null. The reason is written to the run log. Optional successful values remain null or empty when Pinterest omits them. The single dataset view exposes object fields as useful columns; arrays are kept in their parent row rather than expanded into additional rows or views.

Input and pagination settings ⚙️

Parameter	Type	Required	Default	Rules
inputList	array of strings	Yes	None	Enter keyword queries or canonical Pinterest /search/boards/?q= URLs.
pagesPerSearch	integer	No	1	Maximum result pages per input. Website page sizes vary; short pages can still have a continuation. Preparation requests do not count as result pages. Minimum 1.

Enter nonblank topic phrases. Use Profile Boards Scraper when you want the collections of a specific username, or Board Pins Scraper when you already have a board URL.

Use canonical HTTPS links on www.pinterest.com or pinterest.com. Country-specific hosts, shortened pin.it links and unsupported paths are not accepted. Search inputs must contain a nonblank query of at most 1,000 characters. A matching canonical Pinterest search URL with one q parameter is also accepted.

Duplicate normalized inputs are processed once. A returned identifier is deduplicated within the pagination of one source input; the same object found under different source inputs retains each source relationship.

The first result request counts as page 1. Source validation and preparation requests do not consume result pages. A short or filtered page can continue if it supplies a usable cursor. Collection stops at the page budget or the end of pagination; a repeated cursor does not trigger an endless loop.

Pinterest board search results use cases 🎯

Curated collection discovery

Search a topic and review matching board descriptions and covers. Choose suitable collections before collecting their pins.

Research source catalogs

Export board URLs, owners and visible counts to prepare a source catalog. Keep the search phrase when joining results from multiple topics.

Topic landscape samples

Compare board names and descriptions across several keywords. Your own analysis can classify the returned sample without treating it as complete coverage.

Pricing and saved-result behavior 💰

Check the Actor’s Pricing tab for the active charging model and current rate. Store settings may change, so this README does not state an unverified fixed price or runtime.

Under dataset-item pricing:

• Each unique success result represents one board for its source input.
• An invalid or unavailable input, an input with no accessible results, or a request that exhausts retries can produce a failed row.
• Retry attempts and supporting metadata requests do not create extra dataset rows by themselves.
• Nested media, author and source fields stay inside their parent result.
• A normal empty continuation after earlier successes creates no additional result row.
• Saved failed rows are not assumed to be free. Check the active pricing configuration for their treatment.

Larger page budgets and more inputs can produce more saved rows. Start with a small run and check actual usage before increasing the workload.

Pinterest board search results API 🔌

Replace $ACTOR_ID with the identifier shown in this Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputList":["modern kitchen"],"pagesPerSearch":1}'

Download JSON, CSV, Excel, XML or other formats available in the Console, or retrieve the dataset through the Apify API. Schedules, webhooks and Apify integrations can connect results to Google Sheets, Make, Zapier, n8n, cloud storage or your own backend. These are connection options rather than integrations already configured by the Actor.

Reliability, retries, and public-data limits ⚠️

Collection uses pure HTTP with up to five concurrent requests. Invalid syntax and confirmed missing, removed or inaccessible targets stop without unnecessary retries. Temporary network or proxy failures, timeouts, blocking responses, malformed data, throttling and server errors are retried up to five total attempts per request.

Earlier successful pages remain saved when a later request fails. A normal end after previously saved results is not retried. An input that produces no accessible results can receive a failed row; this does not by itself prove the underlying account or collection does not exist. A later exhausted request can append a failed row while keeping earlier output.

Pinterest controls public availability, ranking, fields and pagination. Private, deleted, restricted or otherwise unavailable data can be omitted. Counts can change during collection, and media links can expire. Successful HTTP research confirms the supported request paths and pagination on tested sources, rather than future availability or exhaustive coverage.

Search discovers board metadata and does not collect the contents of every matching board. Results reflect Pinterest’s ranking and public availability rather than a complete index of all relevant collections. Preview pins are not full board exports.

An invalid string within a valid input list does not stop other inputs. A configuration that fails validation, such as a non-string list item or an invalid page-count type, exits before requests start. Infrastructure errors such as startup failure, unavailable dataset storage or an unrecoverable result-save error can stop the whole run. A failed dataset save is not retried as a new scraping request.

Frequently asked questions ❓

Does it return the pins inside each matching board?

No. It returns board rows. Submit selected board URLs to Board Pins Scraper for pin collection.

Can I limit results to one account?

Use Profile Boards Scraper to list a known account’s boards. This Actor searches across the public website by topic.

Are result counts and relevance guaranteed?

No. Pinterest controls matching, ranking, availability and page sizes. Review names, descriptions and source links before selecting boards.

Does it require Pinterest login or personal cookies?

No. The Actor uses HTTP requests from the public website. It does not require a Pinterest account, password or personal session cookie, and does not launch a browser.

What happens to invalid or unavailable inputs?

Invalid individual inputs are saved as failed rows without a source request. Confirmed unavailable targets stop without unnecessary retries. Temporary failures allow up to five total attempts; other inputs and previously saved results remain available.

Can I export results or schedule runs?

Yes. Download the default dataset in supported formats or retrieve it through the Apify API. Apify schedules and completion webhooks can connect repeated runs to your own workflow.

Support, responsible use, and related actors 🛟

For a reproducible issue, use the Actor’s Issues tab and provide the run ID, approximate time, safe public input, expected behavior and actual result. Include the selected mode or page count when applicable. Do not share access tokens, cookies or proxy credentials.

Use public data responsibly and follow applicable privacy, copyright, contractual and platform requirements before storing, analyzing or redistributing collected information.