{ "openapi": "3.0.1", "info": { "title": "Telegram Channel Search - Find Channels by Topic & Keyword", "description": "Find public Telegram channels and groups by keyword, topic, country or language - subscribers, average post reach, ERR, description and t.me link.", "version": "1.0", "x-build-id": "bbOeTtGGpvv7yZbQh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seemuapps~telegram-channel-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seemuapps-telegram-channel-search", "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/seemuapps~telegram-channel-search/runs": { "post": { "operationId": "runs-sync-seemuapps-telegram-channel-search", "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/seemuapps~telegram-channel-search/run-sync": { "post": { "operationId": "run-sync-seemuapps-telegram-channel-search", "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": { "keywords": { "title": "Keywords", "type": "array", "description": "Topics or phrases to search for, in any language (e.g. 'crypto', 'fitness', 'новости'). Each keyword is searched separately and channels are deduplicated across keywords. Leave empty to browse by category, country or language only.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "Adult", "Art", "Betting and gambling", "Blogs", "Books", "Business and startups", "Career", "Courses and guides", "Cryptocurrencies", "Darknet", "Design", "Economics", "Education", "Edutainment", "Erotic", "Esoterics", "Family & Children", "Fashion and beauty", "Food and cooking", "Games", "Handiwork", "Health and Fitness", "Humor and entertainment", "Instagram", "Interior and construction", "Law", "Linguistics", "Marketing, PR, advertising", "Medicine", "Music", "Nature", "News and media", "Other", "Pictures and photos", "Politics", "Psychology", "Quotes", "Religion", "Sales", "Shock content", "Software & Applications", "Sport", "Technologies", "Telegram", "Transport", "Travel", "Video and films" ], "type": "string", "description": "Only return channels in this topic category. Leave empty for any." }, "country": { "title": "Country", "enum": [ "Abkhazia", "Albania", "Algeria", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bangladesh", "Belarus", "Belgium", "Bosnia and Herzegovina", "Brazil", "Bulgaria", "Cambodia", "Canada", "China", "Croatia", "Cuba", "Cyprus", "Czech Republic", "Denmark", "Ecuador", "Egypt", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Greece", "Hungary", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Japan", "Kazakhstan", "Kyrgyzstan", "Latvia", "Lithuania", "Malaysia", "Mexico", "Moldova", "Mongolia", "Montenegro", "Myanmar", "Netherlands", "Nigeria", "North Macedonia", "Norway", "Pakistan", "Panama", "Philippines", "Poland", "Portugal", "Romania", "Russia", "Saudi Arabia", "Serbia", "Singapore", "Slovakia", "Slovenia", "Somalia", "South Africa", "South Korea", "Spain", "Sri Lanka", "Sudan", "Sweden", "Switzerland", "Syria", "Tajikistan", "Tanzania", "Thailand", "Turkey", "Turkmenistan", "UAE", "USA", "Ukraine", "United Kingdom", "Uruguay", "Uzbekistan", "Venezuela", "Vietnam", "Yemen" ], "type": "string", "description": "Only return channels registered to this country. Leave empty for any." }, "language": { "title": "Language", "enum": [ "Abkhazian", "Albanian", "Amharic", "Arabic", "Armenian", "Avar", "Azerbaijani", "Bashkir", "Belarusian", "Bengali", "Bulgarian", "Burmese", "Catalan", "Cebuano", "Chechen", "Chinese", "Croatian", "Czech", "Danish", "Dutch", "English", "Esperanto", "Estonian", "Filipino", "Finnish", "French", "Georgian", "German", "Gujarati", "Hausa", "Hawaiian", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Indonesian", "Italian", "Japanese", "Kannada", "Kazakh", "Khmer", "Korean", "Kyrgyz", "Latin", "Latvian", "Lithuanian", "Macedonian", "Malay", "Malayalam", "Marathi", "Mongolian", "Norwegian", "Oriya", "Pashto", "Persian", "Pidgin", "Polish", "Portuguese", "Punjabi", "Romanian", "Russian", "Serbian", "Sinhalese", "Slovak", "Slovenian", "Somali", "Spanish", "Swahili", "Swedish", "Tagalog", "Tajik", "Tamil", "Tatar", "Telugu", "Thai", "Turkish", "Turkmen", "Ukrainian", "Urdu", "Uzbek", "Vietnamese", "Welsh", "Yakut" ], "type": "string", "description": "Only return channels that post in this language. Leave empty for any." }, "minSubscribers": { "title": "Min subscribers", "minimum": 0, "type": "integer", "description": "Skip channels with fewer subscribers than this. 0 = no minimum.", "default": 0 }, "maxSubscribers": { "title": "Max subscribers", "minimum": 0, "type": "integer", "description": "Skip channels with more subscribers than this (useful for finding small and mid-size channels). 0 = no maximum.", "default": 0 }, "maxItems": { "title": "Max channels per keyword", "minimum": 0, "type": "integer", "description": "Maximum number of channels to return for each keyword (largest channels first). 0 = all matching channels.", "default": 100 }, "searchInDescription": { "title": "Also match channel descriptions", "type": "boolean", "description": "When enabled, a keyword also matches channels that mention it in their description, not just in the title or username. Gives many more results.", "default": true }, "verifiedOnly": { "title": "Verified channels only", "type": "boolean", "description": "Only return channels with the official Telegram verification badge.", "default": false }, "includeChats": { "title": "Include groups", "type": "boolean", "description": "Also return public Telegram groups (chats) from the group ranking: top groups in the selected category, or the overall top groups whose name matches a keyword.", "default": false }, "includeDetails": { "title": "Include description and verified badge", "type": "boolean", "description": "Open each channel's public t.me page to add the full description, verified badge, high-resolution avatar and a live subscriber count. Slightly slower; recommended.", "default": true }, "includeGeoLanguage": { "title": "Include country and language", "type": "boolean", "description": "Look up each channel's country and language. Adds one extra request per channel, so runs are slower. When you filter by Country or Language, those fields are filled automatically without this option.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used for directory requests. The default (Apify datacenter proxy) works well; the actor rotates IPs automatically when it hits a rate limit.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }