{ "openapi": "3.0.1", "info": { "title": "Substack Posts Monitor - Posts, Likes & New-Post Alerts", "description": "Post list for Substack publications from their public archive: title, date, free or paid, likes, comments, restacks, word count, authors and tags. Turn monitoring on and later runs return only the posts published since the last run.", "version": "0.1", "x-build-id": "UET1uwwu3eEwJNFQr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~substack-posts-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-substack-posts-monitor", "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/neverempty~substack-posts-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-substack-posts-monitor", "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/neverempty~substack-posts-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-substack-posts-monitor", "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": "Substack publications", "type": "array", "description": "Publication addresses: https://name.substack.com, the publication's own domain (https://www.lennysnewsletter.com), a post link from that publication, or just the name before .substack.com. One publication per line. For each one the Actor first reads its robots.txt and then its public archive list (/api/v1/archive). Profile links (substack.com/@name) are not publications and come back as an \"invalid-input\" row that is not charged; an address with no Substack publication comes back as a \"no-such-publication\" row that is not charged.", "items": { "type": "string" } }, "maxPostsPerPublication": { "title": "Maximum posts per publication", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Newest posts first; reading a publication stops after this many post rows. In monitoring mode this limits only the first run for a publication (how many of its newest posts are returned and remembered); on later runs every new post is returned.", "default": 50 }, "postedAfter": { "title": "Only posts published on or after", "type": "string", "description": "Optional date (YYYY-MM-DD, UTC). Posts published before it are not returned and reading stops when the archive reaches them." }, "monitoringMode": { "title": "Monitoring mode: return only new posts", "type": "boolean", "description": "Off = return the newest posts of every publication you listed, charged per post row. On = the posts returned for each publication are remembered, and later runs return only posts that were not there before (published after the oldest post returned on the first run and not returned yet). In monitoring mode each publication whose archive was read and has at least one post is charged as one check (publication-checked), and each post that is returned is also charged as one post row (post-returned). The first monitoring run for a publication returns its newest posts once. Like, comment and restack counts are reported in every returned row but a change in those counts alone does not return a post again. Publications are remembered one by one, so adding a publication does not return the others again. Do not put the same publication in two schedules that run at the same moment.", "default": false }, "resetMonitoringState": { "title": "Forget the remembered posts and start over", "type": "boolean", "description": "Clears everything remembered for this Actor on your account before this run reads anything, so this run (with monitoring on) returns the newest posts of each publication once again and charges for them. Use it for one run and turn it off again: left on in a schedule, every run returns and charges the same posts. This affects all your monitoring runs, because publications are remembered one by one rather than per list.", "default": false }, "useProxy": { "title": "Retry once through a residential proxy when a site answers 403 or 429", "type": "boolean", "description": "Requests go directly to each publication. If one answers HTTP 403 or 429, the request is sent one more time through an Apify residential proxy, at most three times in a run; if it is refused again the run stops sending requests and lists what it did not read. Turn this off to never use a proxy.", "default": true } } }, "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 } } } } } } } } } }