{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Scraper - Public Posts, Views, Media", "description": "Posts from public Telegram channels in one schema: text, date, views, reactions, links, media URLs, forwarded-from, channel info. Reads the t.me/s web preview. No login, no API key, no proxy.", "version": "0.1", "x-build-id": "ClmJ4Lbk5UkxSaBNp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapefy~telegram-channel-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapefy-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/scrapefy~telegram-channel-scraper/runs": { "post": { "operationId": "runs-sync-scrapefy-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/scrapefy~telegram-channel-scraper/run-sync": { "post": { "operationId": "run-sync-scrapefy-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", "properties": { "channels": { "title": "Channels", "type": "array", "description": "Public Telegram channels to scrape, one per line. Accepts a username (durov), an @handle (@durov) or a link (https://t.me/durov, https://t.me/s/durov). Private channels, groups, users, bots and invite links have no public preview and are reported as errors in the run summary.", "items": { "type": "string" } }, "maxPostsPerChannel": { "title": "Max posts per channel", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of posts returned for each channel, newest first. The scraper pages back through older posts (about 20 per page) until this many matching posts are found. You are charged only for posts returned.", "default": 20 }, "maxItems": { "title": "Max posts (all channels together)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Optional hard stop for the whole run across all channels. Leave empty for no overall cap (the per-channel limit still applies)." }, "dateFrom": { "title": "Posts from date", "type": "string", "description": "Keep only posts published on or after this date and time (UTC). Format YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ, for example 2026-10-01. Scanning of a channel stops once it reaches older posts. Leave empty for no start date." }, "dateTo": { "title": "Posts until date", "type": "string", "description": "Keep only posts published on or before this date (UTC). A plain date such as 2026-10-20 includes the whole day. Use together with Posts from date to get one time window. Leave empty for no end date." }, "keywords": { "title": "Keywords (post text or links)", "type": "array", "description": "Keep only posts whose text or links contain at least one of these words or phrases, for example bitcoin, airdrop, breaking. Not case sensitive. Leave empty to keep all posts. Posts that do not match are skipped and not charged.", "items": { "type": "string" } }, "includeChannelInfo": { "title": "Include channel info item", "type": "boolean", "description": "Adds one extra row per channel (type = channel) with the title, description, subscriber count as shown on the preview, photo, video and link counters, verified flag and profile picture URL. Billed as a separate channel-info event.", "default": false }, "maxPagesPerChannel": { "title": "Max pages scanned per channel", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety limit on how many preview pages (about 20 posts each) are read per channel, so a keyword or date filter that matches nothing cannot scan a whole channel history. Raise it to search deeper into old posts.", "default": 60 } } }, "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 } } } } } } } } } }