{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Scraper - Public Posts, Views & Reactions", "description": "Scrape public Telegram channels without login or API keys: post text, date, views, reactions, photos and videos, links, hashtags, forwards and replies, plus channel subscribers. Date and keyword filters, new-post monitoring. $1 per 1,000 posts; failed channels are free.", "version": "0.1", "x-build-id": "YajHM1TBQJ29JN87q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidytools~telegram-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidytools-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/tidytools~telegram-channel-scraper/runs": { "post": { "operationId": "runs-sync-tidytools-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/tidytools~telegram-channel-scraper/run-sync": { "post": { "operationId": "run-sync-tidytools-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 or post links", "type": "array", "description": "One per line: a public channel (https://t.me/durov, t.me/s/durov, @durov or durov) or a single post (https://t.me/durov/300). Several per line are fine (spaces, commas or semicolons); pasted quotes are ignored; the same channel written twice is read once. Up to 1,000 per run. Invite links, private channels and lines that are not Telegram links become a free row with errorType \"invalid_input\".", "items": { "type": "string" } }, "maxPostsPerChannel": { "title": "Posts per channel", "minimum": 0, "maximum": 10000, "type": "integer", "description": "The newest N posts of each channel (0 = channel info only). Older posts are read page by page (about 20 posts per page) back to the channel's first post.", "default": 50 }, "postedAfter": { "title": "Only posts published after (optional)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}.*$|^\\d+\\s*(hour|day|week|month|year)s?$", "type": "string", "description": "A date (2026-09-01) or a period (12 hours, 7 days, 3 months). Reading a channel stops at the first older post; older posts are free." }, "keywords": { "title": "Only posts containing (optional)", "type": "array", "description": "Keep only posts whose text or link preview contains any of these words or phrases (case-insensitive). Posts that do not match are free.", "items": { "type": "string" } }, "includeChannelInfo": { "title": "Channel info row", "type": "boolean", "description": "One row per channel: title, description, subscribers, photo, video, file and link counts, verified badge, photo and the latest post ($1 per 1,000 channels).", "default": true }, "includeHtml": { "title": "Include post HTML", "type": "boolean", "description": "Add the post's original HTML (bold, links, custom emoji) next to the plain text.", "default": false }, "onlyNewPosts": { "title": "Only posts newer than the last run (monitoring)", "type": "boolean", "description": "For scheduled runs: return (and charge) only posts newer than the newest post seen by earlier runs with the same monitor name, and each channel info row only once. The first run returns the newest posts and saves the baseline.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate monitors keep separate memories (letters, digits and dashes). Only used with monitoring on.", "default": "default" }, "maxResults": { "title": "Max posts per run", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The run stops after this many post rows (channel rows are not counted). A cost cap on top of Apify's maximum charge per run.", "default": 10000 }, "httpVia": { "title": "Plain HTTP requests from", "enum": [ "auto", "direct", "backend" ], "type": "string", "description": "Every request uses our own user agent and follows robots.txt, with no cookies, login or Telegram account. If Telegram rate-limits one network (HTTP 429), Auto waits briefly, then retries the page from our servers.", "default": "auto" }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Only used for requests sent from Apify's network. Apify proxy usage is billed to your Apify account." }, "maxConcurrency": { "title": "Channels in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many channels are read at the same time (each reads its pages one after another).", "default": 3 }, "pageDelayMs": { "title": "Pause between pages of a channel (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Politeness delay between two older-post pages of the same channel.", "default": 400 } } }, "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 } } } } } } } } } }