{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Search — Topics, Audience & Activity", "description": "Search public Telegram channels by topic and export audience, language, activity and source links from a dated catalog. No Telegram login or live scraping setup required.", "version": "1.0", "x-build-id": "E0GCXDJBY8LLhExum" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/telegrambest~telegram-channel-discovery/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-telegrambest-telegram-channel-discovery", "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/telegrambest~telegram-channel-discovery/runs": { "post": { "operationId": "runs-sync-telegrambest-telegram-channel-discovery", "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/telegrambest~telegram-channel-discovery/run-sync": { "post": { "operationId": "run-sync-telegrambest-telegram-channel-discovery", "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": [ "queries" ], "properties": { "queries": { "title": "What channels are you looking for?", "type": "array", "description": "The topic in the words channels use in their name or description, one per line — e.g. 'AI news', 'crypto trading signals', 'нейросети', 'digital marketing'. Matching is by words over the channel name, description and an English summary of the channel, so an English query also finds many channels written in other languages.", "items": { "type": "string" } }, "languages": { "title": "Only these languages", "type": "array", "description": "Optional. Keep only channels that post in these languages. Leave empty for all. Put the language here, not in the query: 'AI news' + Russian, not 'Russian AI news'.", "items": { "type": "string", "enum": [ "en", "ru", "uk", "kk", "tr", "vi", "de", "es", "pl", "uz", "ar", "zh", "th", "ko", "id", "hi", "fa", "pt", "fr", "it" ], "enumTitles": [ "English", "Russian", "Ukrainian", "Kazakh", "Turkish", "Vietnamese", "German", "Spanish", "Polish", "Uzbek", "Arabic", "Chinese", "Thai", "Korean", "Indonesian", "Hindi", "Persian", "Portuguese", "French", "Italian" ] } }, "minSubscribers": { "title": "Minimum subscribers", "minimum": 0, "type": "integer", "description": "Skip channels smaller than this.", "default": 1000 }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "subscribers", "reach", "engagement" ], "type": "string", "description": "Order of the channels that match your query. 'Relevance' keeps the closest matches first; sorting by size can lift big channels that only mention your topic.", "default": "relevance" }, "maxChannelsPerQuery": { "title": "Max channels per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Upper limit of channels returned for each query. You pay only for channels delivered. On the Apify free plan a run returns at most 50 channels.", "default": 30 }, "mustInclude": { "title": "Must mention (place, brand, niche)", "type": "array", "description": "Optional. Keep only channels whose name, description or summary mentions at least one of these words (matched by word start). Add local spellings too: 'Dubai', 'Дубай'.", "items": { "type": "string" } }, "onlyNew": { "title": "Only channels I have not received yet", "type": "boolean", "description": "Skip channels this Actor already delivered to your account in earlier runs — useful for a scheduled search that watches for new channels.", "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 } } } } } } } } } }