# Substack Lead Gen Scraper (`sourabhbgp/substack-lead-gen`) Actor Generate B2B leads from Substack newsletters — author profiles, subscriber counts, Twitter handles, paid pricing, recommendations network, and sponsorship signals. URL or category mode. Flat $1 per 1,000 profiles. HTTP-only, no browser. - **URL**: https://apify.com/sourabhbgp/substack-lead-gen.md - **Developed by:** [Sourabh Kumar](https://apify.com/sourabhbgp) (community) - **Categories:** Lead generation, News - **Stats:** 26 total users, 11 monthly users, 99.2% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 newsletter profiles 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 Generate B2B leads from [Substack](https://substack.com) newsletters: author profiles, subscriber counts, Twitter/social handles, paid pricing, recommendations network, sponsorship signals, and posting activity. A **Substack API alternative** for sales teams, sponsorship prospectors, and market researchers — HTTP-only, no browser, no proxy. ### What does Substack Lead Gen Scraper do? Substack Lead Gen Scraper turns any Substack newsletter (or an entire category leaderboard) into a structured **lead record** with the author's name, handle, bio, Twitter, custom domain, subscriber count, paid tier pricing, posting frequency, and optional enrichment data. Two modes: - **URL Mode** — paste a list of newsletter URLs and get a detailed profile for each. - **Discovery Mode** — pick a category (Technology, Business, Finance, Crypto, …) and pull the top newsletters with subscriber metrics. Both modes hit Substack's public JSON endpoints directly — no Cloudflare juggling, no headless browser, no proxy required. ### Why scrape Substack? Substack hosts the highest concentration of independent media operators in B2B — solo writers, ex-journalists, and analysts with engaged paid audiences. That makes it a goldmine for: - **📨 Cold outreach to newsletter authors** — pitch a tool, sponsorship, or interview using the author's name, handle, and Twitter. - **💰 Sponsorship prospecting** — combine subscriber count + paid tier price to estimate audience value before you reach out. - **📈 Market research** — map the newsletter landscape in your category and benchmark against competitors. - **🏢 Competitive intelligence** — track who's paid vs. free, who's growing (bestseller tier), who recommends whom. - **🎯 Influencer & thought-leader discovery** — sort by subscriber count and bestseller tier to surface the loudest voices in any niche. Apify platform extras: scheduled runs, REST/JS/Python API, integrations with Make/Zapier/n8n, dataset export to JSON/CSV/Excel, and pay-per-result billing. ### What data can Substack Lead Gen Scraper extract? | Field | Type | Description | |---|---|---| | `name` | string | Newsletter name (e.g., *The Pragmatic Engineer*) | | `authorName` | string | Author's display name | | `authorHandle` | string | Substack handle (`@pragmaticengineer`) | | `authorBio` | string | Author bio / about text | | `twitterHandle` | string | Twitter/X handle | | `websiteUrl` | string | Author's external website | | `subscriberCount` | string | Free subscriber count (e.g., `241,000`) | | `subscriberCountEstimate` | string | Order-of-magnitude estimate (`241K+`) | | `bestsellerTier` | number | Substack bestseller tier (1 = top tier) | | `hasPaidSubscription` | boolean | Whether a paid tier exists | | `monthlyPriceCents` / `yearlyPriceCents` | number | Paid tier pricing | | `estimatedPostsPerMonth` | number | Posting frequency from the last ~5 posts | | `lastPostDate` | string | Most recent post timestamp | | `category` | string | Substack category | | `customDomain` | string | Custom domain (e.g., `newsletter.pragmaticengineer.com`) | | `hasPodcast` / `hasCommunity` | boolean | Feature flags on the publication | Plus optional enrichment fields (recommendations, contributors, full pricing plans, sponsorship signal, recent podcast guests, health flags) — see the **Enrichment flags** section below. ### How to scrape Substack newsletters 1. Click **Try for free** on the Apify Store page. 2. Choose your mode: - **URL mode** — paste full newsletter URLs (must include `https://`) into the **Newsletter URLs** field. - **Discovery mode** — pick a **Category** from the dropdown and (optionally) a **Newsletter Type** (`all`, `paid`, `free`). 3. Set **Max Results** (default `50`, max `1000`). 4. (Optional) Enable any **enrichment flags** — sponsorship signal, recommendations network, contributors, full pricing, health signals, recent guests. 5. Click **Start** and watch results populate the dataset in real time. 6. Export as JSON, CSV, Excel, or HTML, or stream them via the Apify API into your CRM / data warehouse. You can also schedule the run (daily/weekly) to keep a live snapshot of any category, or trigger it from Make / Zapier / n8n when you need fresh leads on demand. ### How much does it cost to scrape Substack? Flat **$1.00 per 1,000 newsletter profiles** (`$0.001 per profile`). Enrichment flags do not add to the price — only the result count is billed. | Volume | Cost | |---|---| | 100 newsletters | $0.10 | | 500 newsletters | $0.50 | | 1,000 newsletters | $1.00 | | 10,000 newsletters | $10.00 | The Apify Free plan includes $5 of platform usage per month — enough to pull ~5,000 newsletter profiles before paying for results. ### Input See the **Input** tab for the full configuration UI. The two main parameters: - `urls` — array of full newsletter URLs. Must include `https://`. Custom domains and `*.substack.com` subdomains both work. - `category` — one of the 31 official Substack category slugs (case-sensitive). Use the dropdown to avoid typos. You can provide **either** `urls` **or** `category` — or both in the same run. #### URL Mode ```json { "urls": [ "https://newsletter.pragmaticengineer.com", "https://platformer.news", "https://lenny.substack.com" ] } ```` #### Discovery Mode ```json { "category": "technology", "newsletterType": "paid", "maxResults": 100 } ``` #### All input parameters | Parameter | Type | Default | Description | |---|---|---|---| | `urls` | string\[] | — | Newsletter URLs (substack.com or custom domains, with `https://`) | | `category` | string | — | Category slug for discovery mode (e.g., `technology`) | | `newsletterType` | enum | `all` | `all`, `paid`, or `free` | | `maxResults` | integer | `50` | Max newsletter profiles to return (1–1000) | | `includeActivityMetrics` | boolean | `true` | Calculate posting frequency + last post date | | `includeHomepageLinks` | boolean | `false` | External links + sponsorship signal | | `includeRecommendations` | boolean | `false` | Outbound + inbound recommendations | | `includeContributors` | boolean | `false` | Co-authors / contributors | | `includeFullPricing` | boolean | `false` | All Stripe plans + group coupons | | `includeHealthSignals` | boolean | `false` | paymentsState, paused, spam flag, etc. | | `includeGuests` | boolean | `false` | Recent podcast / co-author guests | | `concurrency` | integer | `20` | Newsletters processed in parallel (1–50) | | `requestDelayMs` | integer | `0` | Per-worker delay in ms (raise if rate-limited) | ### Output You can download the dataset in various formats such as **JSON**, **HTML**, **CSV**, or **Excel**. Each newsletter is one record: ```json { "name": "The Pragmatic Engineer", "description": "Big Tech and high-growth startups, from the inside.", "url": "https://newsletter.pragmaticengineer.com", "substackUrl": "https://pragmaticengineer.substack.com", "customDomain": "newsletter.pragmaticengineer.com", "logoUrl": "https://substackcdn.com/image/...", "language": "en", "createdAt": "2019-07-15T00:00:00.000Z", "authorName": "Gergely Orosz", "authorHandle": "pragmaticengineer", "authorBio": "Writing about big tech and startups...", "authorPhotoUrl": "https://substackcdn.com/image/...", "twitterHandle": "GergelyOrosz", "websiteUrl": "https://newsletter.pragmaticengineer.com", "socialLinks": [ { "platform": "twitter", "url": "https://twitter.com/GergelyOrosz" } ], "subscriberCount": "241,000", "subscriberCountEstimate": "241K+", "paidSubscriberDetail": "Thousands of paid subscribers", "bestsellerTier": 1, "hasPaidSubscription": true, "monthlyPriceCents": 1500, "yearlyPriceCents": 15000, "lastPostDate": "2026-02-25T12:00:00.000Z", "estimatedPostsPerMonth": 8.2, "category": "Technology", "hasPodcast": true, "hasCommunity": true, "scrapedAt": "2026-02-27T10:30:00.000Z" } ``` ### Enrichment flags All flags are **optional** and **off by default**. Enabling them adds extra HTTP calls per newsletter (no extra billing — pricing is per result, not per call): | Flag | What you get | Extra HTTP calls per newsletter | |---|---|---| | `includeHomepageLinks` | External links + `acceptsSponsorships: boolean` + `sponsorshipInquiryUrl` | 1 | | `includeRecommendations` | Outbound + inbound recommendation network | 2 | | `includeContributors` | Co-authors / contributors with handles, photos, bios | 0 (Discovery) / 1 (URL) | | `includeFullPricing` | All Stripe plans, founding tier, group coupons | 0 (Discovery) / 1 (URL) | | `includeHealthSignals` | paymentsState, pauseReturnDate, flaggedAsSpam, explicit, noIndex/noFollow, inviteOnly | 0 (Discovery) / 1 (URL) | | `includeGuests` | Recent podcast / co-author guests across last 12 posts | 1 (free if Activity Metrics is on) | In URL mode, `includeContributors` / `includeFullPricing` / `includeHealthSignals` share a single `posts/by-id/{id}` call per newsletter, so enabling all three together still costs only one extra HTTP call. > ℹ️ `recommendedByCount` reflects the inbound recommendations returned by Substack's `recommendations/to/{pubId}` endpoint, which currently caps at 50 per call. Newsletters with more than 50 inbound recommenders will report `50`. ### Tips & advanced options - **Speed up large discovery runs** — bump `concurrency` to `40–50`. Discovery mode pulls 25 newsletters per leaderboard call, so 1,000 results finish in seconds. - **If you see rate-limit warnings** — drop `concurrency` to `10` and set `requestDelayMs` to `100–500`. - **Cheaper runs** — leave all enrichment flags off. The base profile already includes subscriber count, pricing, Twitter handle, and posting frequency — enough for most outreach use cases. - **Filter dead newsletters** — enable `includeHealthSignals` and discard records where `paymentsState !== "active"`, `flaggedAsSpam === true`, or `pauseReturnDate` is set. - **Find sponsorship-friendly authors** — enable `includeHomepageLinks` and filter `acceptsSponsorships === true`. ### Available categories Culture, Technology, Business, U.S. Politics, Finance, Food & Drink, Podcast, 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. Use the **Category** dropdown in the input form to pick the exact slug. ### What's new in v0.3 - 6 new opt-in **enrichment flags** (sponsorship signal, recommendations, contributors, full pricing, health signals, guests). - Worker-pool **concurrency** (default 20) — large discovery jobs finish in a fraction of v0.2 time. - Cleaner error handling — input issues now exit with a status message instead of marking the run **Failed**. #### Heads-up for v0.2 users (breaking changes) - The **"first 100 free" wedge has been removed.** All results are charged at $0.001 each from result 1. - **URLs must include `https://`.** Bare domains like `newsletter.pragmaticengineer.com` are rejected. - **Categories must be one of the 31 official Substack slugs (case-sensitive).** Variants like `"Technology"` or `"tech"` are rejected — use the dropdown. ### FAQ #### Is it legal to scrape Substack? The actor only reads data that Substack itself exposes publicly via its own JSON endpoints — the same data any visitor can see in their browser. We do not bypass logins, paywalls, or rate limits, and we do not extract paid-only post content. #### Why is my custom domain returning no profile? Make sure the URL includes `https://`. Bare hostnames like `newsletter.example.com` are rejected by the input schema. #### How fresh is the data? Live — every run hits Substack's API directly. No caching layer. #### Can I scrape posts / full content? This actor is for **lead generation** (publication + author + metrics). For full post content, use the [Substack Scraper](https://apify.com/sourabhbgp/substack-scraper). #### Why does `recommendedByCount` cap at 50? Substack's `recommendations/to/{pubId}` endpoint returns a maximum of 50 recommenders per call. Pagination support is tracked for v0.4. #### What if a run fails or migrates mid-way? The actor checkpoints pushed records on every push and on platform `migrating` events. Resumed runs skip already-pushed newsletters and won't double-charge. ### Disclaimer Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly on Substack. We therefore believe that this actor, when used for ethical purposes by Apify users, is safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. ### Support & feedback - Found a bug or want a feature? Open it on the **Issues** tab. - Need programmatic access? See the **API** tab for ready-to-use code snippets in JS, Python, and curl. ### Related actors - [Substack Scraper](https://apify.com/sourabhbgp/substack-scraper) — scrape full post content from Substack newsletters # Actor input Schema ## `urls` (type: `array`): List of full Substack newsletter URLs. Must include the protocol. Examples: ✓ https://newsletter.pragmaticengineer.com ✗ newsletter.pragmaticengineer.com (no protocol) ✗ www.platformer.news (no protocol). Custom domains and \*.substack.com subdomains both work. ## `category` (type: `string`): Pick from the 31 official Substack categories. Case-sensitive — exact slug required. ## `newsletterType` (type: `string`): Filter by newsletter type in discovery mode. ## `maxResults` (type: `integer`): Maximum number of newsletter profiles to return. ## `includeActivityMetrics` (type: `boolean`): Fetch recent posts to calculate posting frequency and last post date. Adds ~0.5s per newsletter but provides valuable activity data. ## `includeHomepageLinks` (type: `boolean`): Fetch the author's external links (book pages, sponsor inquiry pages, course CTAs). Auto-detects whether the author accepts sponsorships. Adds 1 HTTP call per newsletter. ## `includeRecommendations` (type: `boolean`): Fetch outbound recommendations (who this newsletter recommends) and inbound recommendations (who recommends this newsletter). Adds 2 HTTP calls per newsletter. ## `includeContributors` (type: `boolean`): Include co-authors and contributors with their handles, photos, and bios. Free in Discovery mode. ## `includeFullPricing` (type: `boolean`): Include full Stripe plans (all currencies, founding-member tier, group coupons, minimum group size). Free in Discovery mode. ## `includeHealthSignals` (type: `boolean`): Surface paymentsState, pauseReturnDate, flaggedAsSpam, explicit, noIndex/noFollow, inviteOnly. Useful for filtering dead or paused newsletters before outreach. ## `includeGuests` (type: `boolean`): Scan up to 12 recent posts for podcast/co-author guests (authors marked is\_guest=true). Adds 1 HTTP call per newsletter (free if Activity Metrics is also on). ## `concurrency` (type: `integer`): How many newsletters to process in parallel. Higher = faster runs, but higher chance of Substack rate-limiting. ## `requestDelayMs` (type: `integer`): Optional delay between requests inside one worker. Set to 100-500 if you see rate-limit warnings. ## Actor input object example ```json { "urls": [ "https://newsletter.pragmaticengineer.com", "https://platformer.news" ], "newsletterType": "all", "maxResults": 50, "includeActivityMetrics": true, "includeHomepageLinks": false, "includeRecommendations": false, "includeContributors": false, "includeFullPricing": false, "includeHealthSignals": false, "includeGuests": false, "concurrency": 20, "requestDelayMs": 0 } ``` # Actor output Schema ## `newsletters` (type: `string`): Newsletter profiles extracted from Substack including author, subscriber count, contact data, pricing, and activity metrics. # 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 = { "urls": [ "https://newsletter.pragmaticengineer.com", "https://platformer.news" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sourabhbgp/substack-lead-gen").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 = { "urls": [ "https://newsletter.pragmaticengineer.com", "https://platformer.news", ] } # Run the Actor and wait for it to finish run = client.actor("sourabhbgp/substack-lead-gen").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://newsletter.pragmaticengineer.com", "https://platformer.news" ] }' | apify call sourabhbgp/substack-lead-gen --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sourabhbgp/substack-lead-gen", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Substack Lead Gen Scraper", "description": "Generate B2B leads from Substack newsletters — author profiles, subscriber counts, Twitter handles, paid pricing, recommendations network, and sponsorship signals. URL or category mode. Flat $1 per 1,000 profiles. HTTP-only, no browser.", "version": "0.3", "x-build-id": "ePhPDnEGDgBpbGnFf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~substack-lead-gen/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-substack-lead-gen", "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/sourabhbgp~substack-lead-gen/runs": { "post": { "operationId": "runs-sync-sourabhbgp-substack-lead-gen", "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/sourabhbgp~substack-lead-gen/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-substack-lead-gen", "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": "Newsletter URLs", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "List of full Substack newsletter URLs. Must include the protocol. Examples: ✓ https://newsletter.pragmaticengineer.com ✗ newsletter.pragmaticengineer.com (no protocol) ✗ www.platformer.news (no protocol). Custom domains and *.substack.com subdomains both work.", "items": { "type": "string", "pattern": "^https?://[^\\s]+$" } }, "category": { "title": "Category (Discovery Mode)", "enum": [ "culture", "technology", "business", "us-politics", "finance", "food", "podcast", "sports", "art", "world-politics", "health-politics", "news", "fashionandbeauty", "music", "faith", "climate", "science", "literature", "fiction", "health", "design", "travel", "parenting", "philosophy", "comics", "international", "crypto", "history", "humor", "education", "film-and-tv" ], "type": "string", "description": "Pick from the 31 official Substack categories. Case-sensitive — exact slug required." }, "newsletterType": { "title": "Newsletter Type", "enum": [ "all", "paid", "free" ], "type": "string", "description": "Filter by newsletter type in discovery mode.", "default": "all" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of newsletter profiles to return.", "default": 50 }, "includeActivityMetrics": { "title": "Include Activity Metrics", "type": "boolean", "description": "Fetch recent posts to calculate posting frequency and last post date. Adds ~0.5s per newsletter but provides valuable activity data.", "default": true }, "includeHomepageLinks": { "title": "Include Homepage Links + Sponsorship Signal", "type": "boolean", "description": "Fetch the author's external links (book pages, sponsor inquiry pages, course CTAs). Auto-detects whether the author accepts sponsorships. Adds 1 HTTP call per newsletter.", "default": false }, "includeRecommendations": { "title": "Include Recommendations Network", "type": "boolean", "description": "Fetch outbound recommendations (who this newsletter recommends) and inbound recommendations (who recommends this newsletter). Adds 2 HTTP calls per newsletter.", "default": false }, "includeContributors": { "title": "Include Contributors", "type": "boolean", "description": "Include co-authors and contributors with their handles, photos, and bios. Free in Discovery mode.", "default": false }, "includeFullPricing": { "title": "Include Full Pricing Tiers", "type": "boolean", "description": "Include full Stripe plans (all currencies, founding-member tier, group coupons, minimum group size). Free in Discovery mode.", "default": false }, "includeHealthSignals": { "title": "Include Health Signals", "type": "boolean", "description": "Surface paymentsState, pauseReturnDate, flaggedAsSpam, explicit, noIndex/noFollow, inviteOnly. Useful for filtering dead or paused newsletters before outreach.", "default": false }, "includeGuests": { "title": "Include Recent Guests", "type": "boolean", "description": "Scan up to 12 recent posts for podcast/co-author guests (authors marked is_guest=true). Adds 1 HTTP call per newsletter (free if Activity Metrics is also on).", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many newsletters to process in parallel. Higher = faster runs, but higher chance of Substack rate-limiting.", "default": 20 }, "requestDelayMs": { "title": "Request Delay (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Optional delay between requests inside one worker. Set to 100-500 if you see rate-limit warnings.", "default": 0 } } }, "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 } } } } } } } } } } ```