{
"openapi": "3.0.1",
"info": {
"title": "Telegram Channel Scraper & Monitor: New Posts, Views",
"description": "Scrape posts from public Telegram channels (text, date, views, reactions, media links, link previews, polls) and monitor only the new or edited ones between runs. Keyword and view filters. No login, no proxies, pay per post.",
"version": "0.2",
"x-build-id": "FpflpepO32LNwqAEA"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/kislov-data~telegram-channel-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-kislov-data-telegram-channel-monitor",
"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/kislov-data~telegram-channel-monitor/runs": {
"post": {
"operationId": "runs-sync-kislov-data-telegram-channel-monitor",
"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/kislov-data~telegram-channel-monitor/run-sync": {
"post": {
"operationId": "run-sync-kislov-data-telegram-channel-monitor",
"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": "One entry per public channel: telegram, @durov, https://t.me/bbcrussian or https://t.me/s/bbcrussian. Only public channels that have a web preview work. Private channels, invite links, groups, bots and user accounts are not supported.",
"default": [
"telegram"
],
"items": {
"type": "string"
}
},
"maxPostsPerChannel": {
"title": "Max posts per channel",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "How many of the newest posts to return for each channel (20 posts per page loaded). In monitor mode (see Only new posts) every later run returns all new posts since the previous run, up to 1,000 per channel.",
"default": 20
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Keep only posts whose text, poll question or link title contains at least one of these words (case-insensitive). Example: bitcoin, giveaway.",
"items": {
"type": "string"
}
},
"excludeKeywords": {
"title": "Exclude keywords",
"type": "array",
"description": "Skip posts that contain any of these words.",
"items": {
"type": "string"
}
},
"minViews": {
"title": "Minimum views",
"minimum": 0,
"type": "integer",
"description": "Keep only posts with at least this many views. 0 means no limit.",
"default": 0
},
"postedWithinDays": {
"title": "Posted within the last N days",
"minimum": 0,
"maximum": 3650,
"type": "integer",
"description": "Keep only posts published in the last N days. 0 means no limit.",
"default": 0
},
"includeMedia": {
"title": "Include media links",
"type": "boolean",
"description": "Include photo, video and thumbnail links. Turn off for smaller output.",
"default": true
},
"analytics": {
"title": "Channel analytics report",
"type": "boolean",
"description": "Also build an ANALYTICS record (key-value store, no extra charge): reach and reaction rates, best posts by views and by reactions per view, best posting hours and weekdays (UTC), performance by format (text, photo, video, link, poll), top terms, hashtags and linked domains. Works best with 100+ posts per channel (raise Max posts per channel).",
"default": false
},
"trackChanges": {
"title": "Track changes between runs",
"type": "boolean",
"description": "Remember what was already returned and mark every post as new, updated (edited text) or unchanged.",
"default": false
},
"onlyNewPosts": {
"title": "Only new posts (monitor mode)",
"type": "boolean",
"description": "From the second run on, return only posts that are new or edited since the last run. The first run returns the latest posts. Schedule the Actor (hourly, daily) and connect it to Slack, Google Sheets, Make, Zapier or a webhook.",
"default": false
},
"stateName": {
"title": "State storage name",
"type": "string",
"description": "Name of the key-value store used to remember previous runs. Use a different name for each separate monitoring job.",
"default": "telegram-monitor-state"
},
"concurrency": {
"title": "Parallel channels",
"minimum": 1,
"maximum": 6,
"type": "integer",
"description": "How many channels to load at the same time. Keep low to be gentle with Telegram.",
"default": 3
}
}
},
"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
}
}
}
}
}
}
}
}
}
}