# Substack Leaderboard Scraper (`parsebird/substack-leaderboard-scraper`) Actor Scrape Substack leaderboard rankings across 30 categories. Extract top bestseller and rising publications with subscriber counts, pricing tiers, author details, and ranking metrics. - **URL**: https://apify.com/parsebird/substack-leaderboard-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Categories:** AI, Agents, News - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 substack leaderboard entries This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ### Substack Leaderboard Scraper Scrape Substack leaderboard rankings across 30 categories. Extract top bestseller and rising publications with subscriber counts, pricing, author details, badge tiers, and publication URLs.
Track the highest-earning and fastest-growing paid newsletters on Substack — extract rankings, subscriber counts, subscription pricing, author details, badge tiers, and publication URLs from every category leaderboard.

ParseBird Substack Suite   •  Newsletter intelligence at scale
 Leaderboard
➤ You are here 		 More coming soon
Additional Substack scrapers in development
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```` parsebird/substack-leaderboard-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/substack-leaderboard-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items for results. Key inputs: categories (array of strings, default \["bestseller"], multi-select from 31 category slugs), boardTypes (array of strings, default \["paid"], options: "paid"/"rising"), maxResults (integer, default 100). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~substack-leaderboard-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations ```` ### What does Substack Leaderboard Scraper do? This Actor scrapes Substack's leaderboard API, which ranks the highest-earning and fastest-growing paid publications across 30 categories. For each publication on the leaderboard, it extracts: - **Rank** — position on the leaderboard (1-100 per board) - **Publication name** — the newsletter's display name - **Author name, handle, and bio** — the writer behind the publication - **Subscriber count** — total (free + paid) subscriber count (e.g. "257,000") - **Subscriber count magnitude** — abbreviated form (e.g. "257K+") - **Paid subscriber detail** — paid subscriber tier description (e.g. "Thousands of paid subscribers") - **Total subscriber detail** — full subscriber text (e.g. "Over 257,000 subscribers") - **Subscription pricing** — monthly and annual price in USD - **Badge tier** — bestseller badge color indicating paid subscriber count: - Purple = 10,000+ paid subscribers - Orange = 1,000+ paid subscribers - White = 100+ paid subscribers - **Publication URL** — the actual website/domain of the newsletter - **Profile URL** — Substack profile page link - **Subscribe URL** — direct link to the subscription page - **Description** — publication tagline/hero text - **Author photo/logo** — avatar and logo image URLs ### How the leaderboards work Substack has two types of leaderboards per category: - **Top Bestsellers** (`paid`) — ranked by estimated annual recurring revenue (ARR) from paid subscriptions. Updated daily. - **Rising** (`rising`) — ranked by recent paid subscriber growth velocity. Updated every few hours and highly volatile. Each board shows up to 100 publications. There are 30 categories plus a cross-category "All Categories" board (note: "All Categories" only has a Rising board). You can select **multiple categories** and **both board types** in a single run. ### Input parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `categories` | Array of strings | `["bestseller"]` | Categories to scrape. Select one or more. Use `bestseller` for cross-category, or specific categories like `technology`, `culture`, `business`, etc. | | `boardTypes` | Array of strings | `["paid"]` | Board types to scrape. Select one or both: `paid` for Top Bestsellers (by revenue), `rising` for Rising (by growth). | | `maxResults` | Integer | `100` | Maximum total publications to return across all selected categories and board types. | #### Available categories | Slug | Category | |------|----------| | `bestseller` | All Categories (Rising only) | | `culture` | Culture | | `technology` | Technology | | `business` | Business | | `us-politics` | U.S. Politics | | `finance` | Finance | | `food-drink` | Food & Drink | | `sports` | Sports | | `art-illustration` | Art & Illustration | | `world-politics` | World Politics | | `health-politics` | Health Politics | | `news` | News | | `fashion-beauty` | Fashion & Beauty | | `music` | Music | | `faith-spirituality` | Faith & Spirituality | | `climate-environment` | Climate & Environment | | `science` | Science | | `literature` | Literature | | `fiction` | Fiction | | `health-wellness` | Health & Wellness | | `design` | Design | | `travel` | Travel | | `parenting` | Parenting | | `philosophy` | Philosophy | | `comics` | Comics | | `international` | International | | `crypto` | Crypto | | `history` | History | | `humor` | Humor | | `education` | Education | | `film-tv` | Film & TV | ### Output example ```json { "rank": 1, "publicationName": "SemiAnalysis", "publicationUrl": "https://newsletter.semianalysis.com", "authorName": "Dylan Patel", "authorHandle": "semianalysis", "authorBio": "Bridging the gap between business and the worlds most important industry.", "authorPhotoUrl": "https://substackcdn.com/image/fetch/...", "logoUrl": "https://substackcdn.com/image/fetch/...", "description": "Bridging the gap between the world's most important industry, semiconductors, and business.", "bestsellerBadgeTier": "orange", "subscriberCount": "257,000", "subscriberCountMagnitude": "257K+", "paidSubscriberDetail": "Thousands of paid subscribers", "totalSubscriberDetail": "Over 257,000 subscribers", "monthlyPrice": 50.0, "annualPrice": 500.0, "currency": "USD", "profileUrl": "https://substack.com/@semianalysis", "subscribeUrl": "https://newsletter.semianalysis.com/subscribe", "category": "technology", "boardType": "paid", "scrapedAt": "2026-04-21T12:00:00.000Z" } ```` ### Use cases - **Newsletter market research** — See which publications dominate each category by revenue and subscriber count - **Competitive analysis** — Track competitors' leaderboard positions and growth over time - **Content strategy** — Identify underserved categories with fewer top publications - **Pricing intelligence** — Compare subscription pricing across categories to find market rates - **Trend monitoring** — Use the Rising board to spot newsletters gaining traction fast - **Lead generation** — Build targeted lists of newsletter authors for partnerships or outreach - **Investment research** — Track the newsletter creator economy's top performers with subscriber metrics ### How it works 1. Fetches data from Substack's internal leaderboard API for each selected category and board type 2. Paginates through results (25 per page, up to 100 per board) 3. Extracts publication metadata including subscriber counts, pricing, and badge tiers 4. Returns structured data for each publication with all available fields ### Pricing This actor uses a pay-per-event model. Each leaderboard entry extracted counts as one event. | Event | Price per 1000 | |-------|---------------| | `substack-leaderboard-entry` | $4.00 | A full category board (100 publications) costs approximately $0.40. Selecting 2 categories with both board types (up to 400 entries) costs approximately $1.60. ### Legal and compliance This actor accesses publicly available leaderboard data from Substack's API. No authentication is required. The data represents publicly visible rankings and publication metadata. Always review and comply with the website's Terms of Service before use. # Actor input Schema ## `categories` (type: `array`): Substack leaderboard categories to scrape. Select one or more. 'All Categories' shows the cross-category bestseller list. ## `boardTypes` (type: `array`): Which leaderboards to scrape. Select one or both. Top Bestsellers — ranked by annual recurring revenue (ARR) Rising — ranked by recent paid subscriber growth ## `maxResults` (type: `integer`): Maximum total publications to return across all selected categories and board types. Each board has up to 100 entries. ## Actor input object example ```json { "categories": [ "bestseller" ], "boardTypes": [ "paid" ], "maxResults": 100 } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/substack-leaderboard-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("parsebird/substack-leaderboard-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 '{}' | apify call parsebird/substack-leaderboard-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parsebird/substack-leaderboard-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Substack Leaderboard Scraper", "description": "Scrape Substack leaderboard rankings across 30 categories. Extract top bestseller and rising publications with subscriber counts, pricing tiers, author details, and ranking metrics.", "version": "1.1", "x-build-id": "TLIesoNm6xTGBI83n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~substack-leaderboard-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-substack-leaderboard-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/parsebird~substack-leaderboard-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-substack-leaderboard-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/parsebird~substack-leaderboard-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-substack-leaderboard-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": { "categories": { "title": "Categories", "type": "array", "description": "Substack leaderboard categories to scrape. Select one or more. 'All Categories' shows the cross-category bestseller list.", "items": { "type": "string", "enum": [ "bestseller", "culture", "technology", "business", "us-politics", "finance", "food-drink", "sports", "art-illustration", "world-politics", "health-politics", "news", "fashion-beauty", "music", "faith-spirituality", "climate-environment", "science", "literature", "fiction", "health-wellness", "design", "travel", "parenting", "philosophy", "comics", "international", "crypto", "history", "humor", "education", "film-tv" ], "enumTitles": [ "All Categories", "Culture", "Technology", "Business", "U.S. Politics", "Finance", "Food & Drink", "Sports", "Art & Illustration", "World Politics", "Health Politics", "News", "Fashion & Beauty", "Music", "Faith & Spirituality", "Climate & Environment", "Science", "Literature", "Fiction", "Health & Wellness", "Design", "Travel", "Parenting", "Philosophy", "Comics", "International", "Crypto", "History", "Humor", "Education", "Film & TV" ] }, "default": [ "bestseller" ] }, "boardTypes": { "title": "Board Types", "type": "array", "description": "Which leaderboards to scrape. Select one or both.\n\nTop Bestsellers — ranked by annual recurring revenue (ARR)\nRising — ranked by recent paid subscriber growth", "items": { "type": "string", "enum": [ "paid", "rising" ], "enumTitles": [ "Top Bestsellers", "Rising" ] }, "default": [ "paid" ] }, "maxResults": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum total publications to return across all selected categories and board types. Each board has up to 100 entries.", "default": 100 } } }, "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 } } } } } } } } } } ```