{
"openapi": "3.0.1",
"info": {
"title": "Telegram Channel Scraper",
"description": "Scrape public Telegram channels without a login or API key. One row per message: text, date, views, reactions, media, links, hashtags, forwards and replies, plus the channel's details. Filter by date or keyword. $0.50 per 1,000 messages.",
"version": "1.0",
"x-build-id": "wCafnzKyMiCIZXR0U"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cyber1nj3ct0r~telegram-channel-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cyber1nj3ct0r-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/cyber1nj3ct0r~telegram-channel-scraper/runs": {
"post": {
"operationId": "runs-sync-cyber1nj3ct0r-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/cyber1nj3ct0r~telegram-channel-scraper/run-sync": {
"post": {
"operationId": "run-sync-cyber1nj3ct0r-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",
"minItems": 1,
"type": "array",
"description": "Public channels, one per line: a user name such as durov or @durov, or a link such as https://t.me/durov or https://t.me/s/durov. Only channels whose messages anyone can read at t.me/s/name work; private channels and invite links do not.",
"items": {
"type": "string"
}
},
"maxMessagesPerChannel": {
"title": "Maximum messages per channel",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Keep at most this many messages of each channel, newest first. You pay per message returned, so this also caps the cost. Telegram shows 20 messages per page, so a channel of 1,000 messages takes about 50 requests.",
"default": 100
},
"postedFrom": {
"title": "Posted from",
"type": "string",
"description": "Keep only messages posted on or after this date. Pick a date or a period such as 7 days or 24 hours."
},
"postedUntil": {
"title": "Posted until",
"type": "string",
"description": "Keep only messages posted on or before this date (a plain date includes the whole day). To read a period in the past, set both dates; the tool jumps straight to the end date instead of reading every newer page."
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Only messages that Telegram's own channel search finds for these words or phrases, such as bitcoin or #news. Several keywords are searched one after the other, and a message found by more than one is returned once, with the keyword that found it. Leave empty to read all messages.",
"items": {
"type": "string"
}
},
"includeChannelInfo": {
"title": "Include a row with the channel's details",
"type": "boolean",
"description": "Add one row per channel with its title, description, number of subscribers, counts of photos, videos, files and links, and the verified mark. It counts as one result.",
"default": true
},
"channelInfoOnly": {
"title": "Channel details only",
"type": "boolean",
"description": "Return only the row with the channel's details and no messages. Quick way to check the size of many channels.",
"default": false
},
"requestTimeoutSecs": {
"title": "Time limit per request",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "How long to wait for one page before giving up.",
"default": 30
},
"userAgent": {
"title": "User-Agent",
"type": "string",
"description": "The name the tool sends with each request. Leave empty to use the tool's own name, which tells site owners what is visiting. Set your own only for sites you run or have permission to use."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}