{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Scraper — Posts, Views & Media", "description": "Export what public Telegram channels post: the message text, when it went up, the view count, photos and video, and what each post forwarded or replied to. Many channels in one run, and a later run picks up only what is new. No login and no phone number; channel names come from the input list.", "version": "0.1", "x-build-id": "dAdY1gnjew8ezUoV1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thenetaji~telegram-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thenetaji-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/thenetaji~telegram-channel-scraper/runs": { "post": { "operationId": "runs-sync-thenetaji-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/thenetaji~telegram-channel-scraper/run-sync": { "post": { "operationId": "run-sync-thenetaji-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 Telegram channels to read, one per line. Any form is accepted: a username, an @handle, a t.me link, a preview link, or a link to a single post. `telegram`, `@telegram`, `https://t.me/telegram`, `https://t.me/s/telegram` and `https://t.me/telegram/435` all resolve to the same channel, and a channel listed twice is read once.\n\nThe channel name has to be known in advance. Telegram publishes no directory, no sitemap and no robots.txt, so channels cannot be enumerated and no list can be offered here.\n\nOnly public channels with a web preview can be read. Private channels, groups and user chats all serve the same join page; a run logs a warning naming each one and continues through the rest of the list.", "items": { "type": "string" } }, "maxItems": { "title": "Max posts per channel", "minimum": 0, "type": "integer", "description": "Maximum posts saved from each channel. A value of 0 removes the cap and lets a run continue to the channel's first post. Telegram serves 20 posts per request and states no way to ask for more, so a cap of 100 is five requests per channel.", "default": 100 }, "before": { "title": "Start before post number", "minimum": 1, "maximum": 100000000, "type": "integer", "description": "Optional. The walk starts just older than this post number and continues backwards; left empty, it starts at the channel's newest post.\n\nTelegram pages by post number rather than by page index, and publishes no page count and no post total. This cursor takes the LOWEST post number on the page last read, which is the opposite of the usual intuition; the value appears as `message_number` on the oldest row of a previous run and is printed in the run log, so it does not have to be computed.\n\nMeasured on a real channel: no cursor returned posts 435-454, 435 returned 414-433 and 414 returned 394-413, giving 80 posts across four calls with zero overlap; 5 returned posts 1-4, so the beginning of a channel is reachable. Applies to the first channel in the list only." }, "after": { "title": "Only posts after number", "minimum": 1, "maximum": 100000000, "type": "integer", "description": "Optional. Only posts newer than this post number are collected, walking forwards. Supplying `newest_message_number` from a previous run picks up exactly what has been posted since.\n\nCannot be combined with the backwards cursor: Telegram honours one cursor and silently ignores the other, so a run carrying both would return posts from one side of the stream rather than the span between the two bounds. Applies to the first channel in the list only." } } }, "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 } } } } } } } } } }