{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Scraper", "description": "Scrape posts from public Telegram channels: text, date, views, reactions, photos, videos, forwards, replies, links and hashtags, plus channel info and subscriber counts. Date and keyword filters, incremental \"only new posts\" mode. No login, phone number or API keys.", "version": "0.0", "x-build-id": "Q696Re4vsmXQTYv5B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rjmacarthy~telegram-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rjmacarthy-telegram-channel-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/rjmacarthy~telegram-channel-scraper/runs": { "post": { "operationId": "runs-sync-rjmacarthy-telegram-channel-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/rjmacarthy~telegram-channel-scraper/run-sync": { "post": { "operationId": "run-sync-rjmacarthy-telegram-channel-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", "required": [ "channels" ], "properties": { "channels": { "title": "Channels", "type": "array", "description": "Public channel usernames or links: durov, @durov, https://t.me/durov, https://t.me/s/durov or a post link such as https://t.me/durov/531. Private invite links (t.me/+...), groups, users and bots are not supported.", "items": { "type": "string" } }, "maxPostsPerChannel": { "title": "Max posts per channel", "minimum": 0, "type": "integer", "description": "Stop after this many posts from each channel (newest first). 0 = no limit (the whole channel history, or everything newer than the date below).", "default": 100 }, "onlyPostsNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Only posts published after this date. Use an absolute date (2026-10-01) or a relative one (7 days, 2 weeks, 24 hours). Leave empty for no date limit." }, "keywords": { "title": "Keywords", "type": "array", "description": "Only output posts whose text contains at least one of these words or phrases (case-insensitive). Posts that don't match are not charged. Leave empty for all posts.", "items": { "type": "string" } }, "includeChannelInfo": { "title": "Include channel info", "type": "boolean", "description": "Add one extra item per channel (type \"channel-info\") with the title, description, subscriber count, photo and media counters.", "default": true }, "includeTextHtml": { "title": "Include post HTML", "type": "boolean", "description": "Also output the post text as HTML (textHtml), with bold, links and other formatting kept. The plain-text field (text) is always included.", "default": false }, "onlyNewPosts": { "title": "Only new posts (incremental mode)", "type": "boolean", "description": "Remember the newest post seen in each channel and, on later runs, output (and charge for) only posts published since. The first run outputs posts as usual and saves the newest one as the starting point.", "default": false }, "stateKey": { "title": "Monitor name (state key)", "type": "string", "description": "Name of this monitor's memory. Runs with the same name share the \"last seen post\" of each channel. Use different names for independent monitors.", "default": "default" }, "stateStoreName": { "title": "State key-value store name", "type": "string", "description": "Named key-value store in your account where incremental state is kept (letters, digits and dashes).", "default": "telegram-channel-scraper-state" }, "maxPagesPerChannel": { "title": "Max pages per channel", "minimum": 0, "type": "integer", "description": "Safety limit on pages fetched per channel (each page has up to 20 posts). 0 = automatic: no limit, except when a keyword filter is used without a date limit, where scanning stops after 100 pages (about 2,000 posts).", "default": 0 }, "requestDelayMs": { "title": "Delay between requests", "minimum": 200, "maximum": 30000, "type": "integer", "description": "Minimum time between two requests to t.me. The default (1 second) is polite and avoids rate limits. If t.me answers with HTTP 429, the scraper slows down further on its own.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed for most runs: t.me previews are public. Turn it on only if t.me rate-limits or blocks the run (for example very large runs).", "default": { "useApifyProxy": 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 } } } } } } } } } }