# Pinterest Board Listings Scraper (`ecomscrape/pinterest-board-listings-scraper`) Actor

Scrape Pinterest board listings from search results or profile pages. Extract board names, pin counts, follower data, cover images, collaboration details, privacy settings, and 35+ metadata fields for research, trend analysis, and content strategy.

- **URL**: https://apify.com/ecomscrape/pinterest-board-listings-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Automation, Developer tools, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)
## 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:
    
![](https://i.ibb.co/HTBk014V/Screenshot-from-2026-03-31-22-14-03.png)

#### 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.
```json
{
  "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

```json
[
    {
  "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.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Boards list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached.

## `keyword` (type: `string`):

Enter the keyword to search for items

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL or search filters you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load

## Actor input object example

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

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.pinterest.com/search/boards/?q=anime&rs=content_type_filter"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 20,
    "max_retries_per_url": 2
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/pinterest-board-listings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.pinterest.com/search/boards/?q=anime&rs=content_type_filter"],
    "ignore_url_failures": True,
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/pinterest-board-listings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.pinterest.com/search/boards/?q=anime&rs=content_type_filter"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 20,
  "max_retries_per_url": 2
}' |
apify call ecomscrape/pinterest-board-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=ecomscrape/pinterest-board-listings-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Pinterest Board Listings Scraper",
        "description": "Scrape Pinterest board listings from search results or profile pages. Extract board names, pin counts, follower data, cover images, collaboration details, privacy settings, and 35+ metadata fields for research, trend analysis, and content strategy.",
        "version": "0.0",
        "x-build-id": "imV1MZmbYwWbKFOoe"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/ecomscrape~pinterest-board-listings-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-ecomscrape-pinterest-board-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/ecomscrape~pinterest-board-listings-scraper/runs": {
            "post": {
                "operationId": "runs-sync-ecomscrape-pinterest-board-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/ecomscrape~pinterest-board-listings-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-ecomscrape-pinterest-board-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "urls": {
                        "title": "URLs of the Boards list urls to scrape",
                        "type": "array",
                        "description": "Add the URLs of the Boards list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "ignore_url_failures": {
                        "title": "Ignore URL failures",
                        "type": "boolean",
                        "description": "If true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached."
                    },
                    "keyword": {
                        "title": "Keyword to search",
                        "type": "string",
                        "description": "Enter the keyword to search for items"
                    },
                    "max_items_per_url": {
                        "title": "Limit the number of items per URL or search filters",
                        "type": "integer",
                        "description": "Limit the number of items per URL or search filters you want to scrape"
                    },
                    "max_retries_per_url": {
                        "title": "Limit the number of retries",
                        "type": "integer",
                        "description": "Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
