Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link: My profile

Pinterest Board Listing Scraper: Extract Board Data & Metadata at Scale

Introduction

Pinterest hosts hundreds of millions of boards spanning fashion, home décor, recipes, art, travel, and virtually every visual niche imaginable. Each board represents a curated collection tied to a theme, audience, and creator — making board-level data valuable for trend researchers, marketers, and competitive analysts who need to understand content organization patterns at scale.

Manually browsing Pinterest board listings is inefficient beyond a few pages. The Pinterest Board Listing Scraper automates extraction of comprehensive board metadata from search result pages, giving you structured, analysis-ready data across dozens of fields without manual effort.

---

Scraper Overview

This scraper retrieves detailed metadata from Pinterest board listing pages — search results, category pages, or any URL that surfaces a list of boards. It captures not just surface-level details like board names and pin counts, but also collaboration settings, privacy status, follower metrics, cover image URLs, and internal classification data.

Key capabilities:

• Dual input modes — scrape via direct URLs or keyword-based search
• Configurable item limits — control how many boards are extracted per URL
• Retry logic — automatically retries failed requests up to a configurable limit
• Error resilience — skips failed URLs without halting the full job
• Rich metadata coverage — 35+ fields per board record

Ideal for social media researchers mapping content ecosystems, marketers benchmarking competitor boards, trend analysts studying popular topics, and data scientists building Pinterest datasets.

---

Input Configuration

Example url 1: https://www.pinterest.com/collectsideshow/marvel-collectibles/x-men/

Example url 2: https://www.pinterest.com/search/pins/?q=anime&rs=content_type_filter

Example url 3: https://www.pinterest.com/AegonTheGreat/anime-world/

Example Screenshot of product information page:

Input Format

The scraper supports two modes: URL-based scraping and keyword search. These are mutually exclusive — if URLs are provided, keyword filters are ignored.

{
  "urls": [
    "https://www.pinterest.com/search/boards/?q=anime&rs=content_type_filter"
  ],
  "ignore_url_failures": true
}

urls — An array of Pinterest board listing page URLs. Supports search results (/search/boards/?q=...), profile board pages, and category listing URLs. Add one by one or use Bulk edit for larger lists.

ignore_url_failures (boolean) — When true, the scraper continues processing remaining URLs if any individual URL fails after the maximum retry attempts. Strongly recommended for batch runs.

keyword (optional, alternative to URLs) — Enter a search keyword instead of URLs to have the scraper construct and query Pinterest board search results automatically. Leave URLs empty when using this mode.

max_items_per_url (integer, default: 20) — Limits the number of boards extracted per URL or per keyword search. Increase for broader coverage; reduce for faster, targeted runs.

max_retries_per_url (integer, default: 2) — Number of retry attempts per URL if the page fails to load or the request is identified as automated. Increasing this can improve success rates on flaky connections.

Output Format

Each board record contains the following fields:

Field	Type	Description
Node ID	String	Internal graph node identifier for the board. Useful for deduplication and API cross-referencing.
ID	String	Pinterest's unique board ID. Primary key for identifying boards across datasets.
Name	String	Board display name. Core field for content categorization and keyword analysis.
Description	String	Creator-written board description. Valuable for NLP, topic modeling, and intent analysis.
URL	String	Full Pinterest URL to the board. Use for direct linking or follow-up scraping.
Owner	Object	Data about the board's creator, including username and profile details.
Privacy	String	Board visibility setting (e.g., public, secret). Key for filtering publicly accessible boards.
Pin Count	Integer	Total number of pins on the board. Primary engagement metric.
Follower Count	Integer	Number of users following the board. Measures audience reach and popularity.
Section Count	Integer	Number of sections the board is organized into. Indicates structural complexity.
Collaborator Count	Integer	Number of collaborators contributing to the board.
Collaborating Users	Array	List of users with contributor access to the board.
Is Collaborative	Boolean	Whether the board accepts contributions from multiple users.
Collaborated By Me	Boolean	Whether the authenticated user is a collaborator on this board.
Collaborator Requests Enabled	Boolean	Whether the board owner allows collaboration requests.
Viewer Collaborator Join Requested	Boolean	Whether the current viewer has a pending join request.
Images	Object	Thumbnail image data associated with the board.
Image Cover URL	String	Standard-resolution cover image URL. For previews and thumbnails.
Image Cover HD URL	String	High-resolution cover image URL. For visual analysis or display applications.
Cover Images	Array	Additional cover image variations at different sizes.
Cover Pin	Object	The pin used as the board's cover image, including its metadata.
Has Custom Cover	Boolean	Whether the creator manually set a custom cover vs. auto-generated.
Created At	Timestamp	Board creation date and time. Useful for temporal analysis and trend tracking.
Board Order Modified At	Timestamp	When the board's pin order was last changed. Indicates recency of active curation.
Event Date	String	Date associated with event-type boards (e.g., wedding boards).
Event Start Date	String	Start date for event boards.
Place Saves Count	Integer	Number of place-tagged pins saved to the board. Relevant for travel and location research.
Followed By Me	Boolean	Whether the authenticated user follows this board.
Access	Array	Access permission levels for the board.
Allow Homefeed Recommendations	Boolean	Whether Pinterest may recommend this board in home feeds.
Should Show More Ideas	Boolean	Whether Pinterest surfaces related ideas below the board.
Should Show Shop Feed	Boolean	Whether a shopping feed is shown on the board. Indicates commercial intent.
Should Show Board Collaborators	Boolean	Whether collaborator avatars are displayed publicly.
Is Ads Only	Boolean	Whether the board is restricted to promoted/advertising content.
Archived By Me At	Timestamp	If the authenticated user archived this board, the timestamp when.
Board Vase	Object	Internal Pinterest classification metadata.
Type	String	Content type classification of the board.
Tracking Params	String	Analytics tracking parameters associated with the board.

Example Output

[
    {
  "node_id": "Qm9hcmQ6NjE3ODM3NzExMzIwNzA0MzEw",
  "images": {
    "170x": [
      {
        "url": "https://i.pinimg.com/170x/d6/a6/ed/d6a6ed9d519428376ab15fd57dffe048.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#000001"
      },
      {
        "url": "https://i.pinimg.com/170x/2a/99/2d/2a992d6a5766fab1d676c88a609d9e90.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#603A93"
      },
      {
        "url": "https://i.pinimg.com/170x/84/c1/d2/84c1d29052d0408475740309d1d68812.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#506C32"
      },
      {
        "url": "https://i.pinimg.com/170x/87/ce/22/87ce22128e6dce57f75f9166ee939f38.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#032B5B"
      },
      {
        "url": "https://i.pinimg.com/170x/57/13/ba/5713ba6b911ccdd3730947e558120960.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#052A6E"
      },
      {
        "url": "https://i.pinimg.com/170x/26/10/a3/2610a3717414a76fdbfc14cacc94e5c9.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#224587"
      },
      {
        "url": "https://i.pinimg.com/170x/9e/09/84/9e09849ed790aebdfbedd6a441556b4c.jpg",
        "width": 170,
        "height": 332,
        "dominant_color": "#0441DE"
      },
      {
        "url": "https://i.pinimg.com/170x/91/1d/4a/911d4ae52b698442e42c0e30b67344f5.jpg",
        "width": 170,
        "height": 331,
        "dominant_color": "#1C335C"
      },
      {
        "url": "https://i.pinimg.com/170x/40/97/f8/4097f8edc26b8a2d76cb2adc7f9e73fb.jpg",
        "width": 170,
        "height": 331,
        "dominant_color": "#212121"
      },
      {
        "url": "https://i.pinimg.com/170x/67/3b/6e/673b6e791f0c691d7dbf7e2d8a28dd31.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#DCA3B0"
      },
      {
        "url": "https://i.pinimg.com/170x/8a/55/bc/8a55bc00a2e0090f516164829b5ed1b4.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#4E4B4E"
      },
      {
        "url": "https://i.pinimg.com/170x/49/ca/df/49cadf9236ca15108e95178ef5eef938.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#5F5F60"
      },
      {
        "url": "https://i.pinimg.com/170x/ac/56/c1/ac56c11bc3e71b81e80e862b8f6ca4aa.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#37343C"
      },
      {
        "url": "https://i.pinimg.com/170x/43/23/f6/4323f6f1ecde4ff7f7b6045356511721.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#888897"
      },
      {
        "url": "https://i.pinimg.com/170x/b3/ea/cc/b3eacc7a475ecee8aa8684d9545a95e4.jpg",
        "width": 170,
        "height": 302,
        "dominant_color": "#441411"
      }
    ]
  },
  "image_cover_url": "https://i.pinimg.com/custom_covers/200x150/617837711320704310_1774881879.jpg",
  "event_date": null,
  "cover_images": {
    "216x146": {
      "url": "https://i.pinimg.com/custom_covers/216x146/617837711320704310_1774881879.jpg",
      "width": 216,
      "height": 146
    },
    "400x300": {
      "url": "https://i.pinimg.com/custom_covers/400x300/617837711320704310_1774881879.jpg",
      "width": 400,
      "height": 300
    }
  },
  "is_collaborative": false,
  "allow_homefeed_recommendations": null,
  "should_show_more_ideas": null,
  "has_custom_cover": null,
  "section_count": 0,
  "privacy": "public",
  "should_show_shop_feed": null,
  "collaborator_count": 0,
  "url": "/AegonTheGreat/anime-world/",
  "collaborating_users": [],
  "created_at": null,
  "viewer_collaborator_join_requested": null,
  "name": "Anime World ⦙",
  "followed_by_me": false,
  "pin_count": 2483,
  "collaborator_requests_enabled": null,
  "type": "board",
  "should_show_board_collaborators": true,
  "tracking_params": null,
  "board_order_modified_at": "Mon, 30 Mar 2026 15:25:53 +0000",
  "cover_pin": {
    "pin_id": "617837642703439811",
    "crop": [
      0,
      92
    ],
    "size": [
      236,
      236
    ],
    "scale": 1,
    "image_url": "https://i.pinimg.com/236x/d6/a6/ed/d6a6ed9d519428376ab15fd57dffe048.jpg",
    "custom_cover": true,
    "timestamp": 1774881879,
    "image_size": [
      236
    ],
    "image_signature": "d6a6ed9d519428376ab15fd57dffe048"
  },
  "id": "617837711320704310",
  "board_vase": null,
  "collaborated_by_me": false,
  "image_cover_hd_url": "https://i.pinimg.com/474x/d6/a6/ed/d6a6ed9d519428376ab15fd57dffe048.jpg",
  "place_saves_count": null,
  "access": [],
  "is_ads_only": null,
  "event_start_date": null,
  "owner": {
    "node_id": "VXNlcjo2MTc4Mzc3ODAwMzgzNjk2NjE=",
    "username": "AegonTheGreat",
    "type": "user",
    "image_medium_url": "https://i.pinimg.com/75x75_RS/48/7c/9f/487c9f069ff84dab9d83633d0918bbbd.jpg",
    "explicitly_followed_by_me": false,
    "verified_identity": {},
    "is_default_image": false,
    "domain_verified": false,
    "is_ads_only_profile": false,
    "image_small_url": "https://i.pinimg.com/30x30_RS/48/7c/9f/487c9f069ff84dab9d83633d0918bbbd.jpg",
    "follower_count": 80605,
    "full_name": "EDEN Ω",
    "is_verified_merchant": false,
    "id": "617837780038369661",
    "image_large_url": "https://i.pinimg.com/140x140_RS/48/7c/9f/487c9f069ff84dab9d83633d0918bbbd.jpg"
  },
  "description": "",
  "archived_by_me_at": null,
  "follower_count": null,
  "from_url": "https://www.pinterest.com/search/boards/?q=anime&rs=content_type_filter"
}
]

---

Usage Guide

Step 1: Choose Your Input Mode

URL mode — Navigate to a Pinterest board search page (e.g., pinterest.com/search/boards/?q=your-topic) and copy the URL. This gives you precise control over which listing page is scraped.

Keyword mode — Leave urls empty and set keyword to your target term. The scraper handles search query construction automatically.

Step 2: Set Item and Retry Limits

• Set max_items_per_url based on your needs. The default of 20 is suitable for quick tests; increase to 100+ for comprehensive research runs.
• Keep max_retries_per_url at 2–3 for most use cases. Increase only if you're experiencing frequent load failures.

Step 3: Enable Error Handling

Always set ignore_url_failures: true for multi-URL batches to prevent one failed page from terminating the job.

Step 4: Process and Filter Output

After extraction, common post-processing steps include:

• Filter by privacy: "public" to retain only publicly accessible boards
• Sort by follower_count or pin_count to identify high-authority boards
• Use is_collaborative to segment community boards from solo-curated ones
• Extract owner details for channel-level grouping

Best Practices

• Test with a small max_items_per_url first (10–20) before scaling up
• Use specific search URLs for niche research rather than broad keyword queries
• Cross-reference node_id and id when merging data from multiple runs to avoid duplicates
• Monitor board_order_modified_at to identify actively maintained boards vs. dormant ones

---

Benefits and Applications

Trend & Niche Research: Identify popular board themes, naming conventions, and pin volumes within a topic area to understand what content resonates with Pinterest audiences.

Competitive Intelligence: Analyze competitor brand boards — follower counts, section structures, collaboration settings, and cover aesthetics — to inform your own Pinterest strategy.

Influencer & Creator Discovery: Use owner and follower_count data to surface high-reach board curators in specific niches for partnership or outreach opportunities.

Dataset Creation: Build labeled Pinterest board datasets for machine learning projects, social media research, or visual content classification systems.

Content Planning: Leverage keywords from board names and descriptions to map content gaps and identify underserved topics in your niche.

---

Conclusion

The Pinterest Board Listing Scraper delivers structured, comprehensive board metadata that would take hours to collect manually. With 35+ fields per record and flexible input options, it supports everything from quick competitive snapshots to large-scale research datasets.

Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Pinterest Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.