{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Content & Media Scraper", "description": "Download photos, videos and posts from any public Telegram channel. Pick only photos, videos, audio or files, get size, resolution and duration for each file, plus post text, views and reactions. Up to 25 channels, no API key or phone needed. Free media downloads, pay only per post.", "version": "0.0", "x-build-id": "vHVkMTohztXISoUMe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webfinity~telegram-channel-content-media-scraper-v2/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webfinity-telegram-channel-content-media-scraper-v2", "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/webfinity~telegram-channel-content-media-scraper-v2/runs": { "post": { "operationId": "runs-sync-webfinity-telegram-channel-content-media-scraper-v2", "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/webfinity~telegram-channel-content-media-scraper-v2/run-sync": { "post": { "operationId": "run-sync-webfinity-telegram-channel-content-media-scraper-v2", "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": "string", "description": "Channel usernames or links, separated by commas or new lines. Accepted: channel, @channel, https://t.me/channel, https://t.me/s/channel. Up to 25 channels per run, of which up to 10 new ones (channels scraped before don't count toward the 10)." }, "maxPosts": { "title": "Max posts per channel", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of recent posts to fetch from each channel. Keep small for faster runs.", "default": 10 }, "daysRange": { "title": "Days lookback", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of past days to include when filtering posts by date.", "default": 3 }, "includeText": { "title": "Include text", "type": "boolean", "description": "Whether to include the text content of each post in the results.", "default": true }, "mediaOnly": { "title": "Media only", "type": "boolean", "description": "If true, only return posts that contain photos, videos or files.", "default": false }, "mediaFilter": { "title": "Media type", "enum": [ "all", "photo", "video", "audio", "document" ], "type": "string", "description": "Return only posts that contain this type of file, and list (or download) only those files. The filter is applied to the posts within Max posts per channel and Days lookback, so raise Max posts to find more. GIFs and stickers count only under \"All media\". Posts without such files are skipped and not charged. Default: all media, as before.", "default": "all" }, "downloadMedia": { "title": "Download media (KV store)", "type": "boolean", "description": "If true, download media files to the run's Key-Value Store and include direct URLs in results. If false, media is returned as t.me links.", "default": false }, "maxMediaSizeMB": { "title": "Max media file size (MB)", "minimum": 0, "type": "integer", "description": "Files larger than this are not downloaded and stay as t.me links. 0 = no limit.", "default": 50 }, "groupAlbums": { "title": "Merge albums into one record", "type": "boolean", "description": "Telegram sends an album as several messages, one file each. Off (default): one record per message, as before. On: one record per album with all files in mediaUrls.", "default": 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 } } } } } } } } } }