{ "openapi": "3.0.1", "info": { "title": "Substack Scraper & API: Posts, Subscribers & Full Text", "description": "Scrape Substack without login: newsletter posts (latest or top), keyword search, author or post links. Likes, comments, restacks, paid flag, newsletter subscriber count, author followers, full text as Markdown and top comments. Date and likes filters, new posts alerts.", "version": "0.1", "x-build-id": "cPBiOkML5pCdLSBY6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~substack-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-substack-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/s_actors~substack-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-substack-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/s_actors~substack-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-substack-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": { "publications": { "title": "Newsletters", "type": "array", "description": "Substack newsletters: a name like \"noahpinion\", a link (noahpinion.substack.com) or a custom domain (www.lennysnewsletter.com). The whole archive, in the order set below.", "items": { "type": "string" } }, "searchQueries": { "title": "Search queries", "type": "array", "description": "Keywords, like the Substack search box: \"ai agents\", \"personal finance\". Posts of all newsletters, most relevant first.", "items": { "type": "string" } }, "authors": { "title": "Authors", "type": "array", "description": "Substack handles (with or without @) or profile links (substack.com/@name). All posts the author wrote, in every newsletter, newest first.", "items": { "type": "string" } }, "postUrls": { "title": "Post links", "type": "array", "description": "Links to Substack posts: /p/ (custom domains too), open.substack.com/pub/... or substack.com/home/post/p-. One row each.", "items": { "type": "string" } }, "sort": { "title": "Newsletter posts order", "enum": [ "latest", "top" ], "type": "string", "description": "Latest: newest first, as deep as the archive goes. Top: the most liked posts of the newsletter first (the \"Top\" tab of its archive).", "default": "latest" }, "publishedAfter": { "title": "Published after", "type": "string", "description": "Only posts published on or after this date: 2026-01-01, or relative: \"7 days\", \"3 months\", \"1 year\"." }, "publishedBefore": { "title": "Published before", "type": "string", "description": "Only posts published before this date (same formats)." }, "minLikes": { "title": "Minimum likes", "minimum": 0, "type": "integer", "description": "Only posts with at least this many likes (hearts). Left-out posts are free." }, "audience": { "title": "Free or paid posts", "enum": [ "all", "free", "paid" ], "type": "string", "description": "All posts, only free ones (full text available), or only paid (subscriber-only) ones.", "default": "all" }, "maxPostsPerSource": { "title": "Max posts per source", "minimum": 1, "maximum": 10000, "type": "integer", "description": "For each newsletter, query and author.", "default": 100 }, "maxPosts": { "title": "Max posts in total", "minimum": 1, "type": "integer", "description": "The run stops at this many posts.", "default": 1000 }, "includeContent": { "title": "Post text (Markdown)", "type": "boolean", "description": "Full text of free posts as Markdown (headings, links, lists, images) and plain text. Paid posts: the free preview Substack shows to visitors (isFullText = false).", "default": true }, "includeSubscriberCounts": { "title": "Subscriber counts", "type": "boolean", "description": "Subscriber count of the newsletter (as Substack shows it, like 1.2M+), its leaderboard rank and the author's followers. One extra request per author.", "default": true }, "commentsPerPost": { "title": "Comments per post", "minimum": 0, "maximum": 100, "type": "integer", "description": "Top comments of each post (with replies) in the row, 0 = none. Paid posts hide their comments from visitors.", "default": 0 }, "onlyNew": { "title": "Only new posts", "type": "boolean", "description": "Output only posts not seen in the previous runs of the same source (and monitor name). Schedule it daily to get new posts of a newsletter, author or keyword.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps the memory of seen posts apart for different schedules." }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Log every request retry.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }