{ "openapi": "3.0.1", "info": { "title": "Telegram Comments Scraper", "description": "Get every public comment under any Telegram post: author name, @handle, text, timestamp, reactions, photos and the comment each one answers — one row each, ready for CSV, Excel or JSON. Point it at a list of posts or a whole channel. No Telegram account, phone number or login needed.", "version": "0.0", "x-build-id": "8rJVZWLqJmzdq3gEv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apt_marble~telegram-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apt_marble-telegram-comments-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/apt_marble~telegram-comments-scraper/runs": { "post": { "operationId": "runs-sync-apt_marble-telegram-comments-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/apt_marble~telegram-comments-scraper/run-sync": { "post": { "operationId": "run-sync-apt_marble-telegram-comments-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", "properties": { "postUrls": { "title": "Post links", "type": "array", "description": "One Telegram post per line, in the form https://t.me//. Copy the link straight from the post. Leave this empty if you would rather point the actor at a channel and let it pick the most recent posts itself.", "default": [ "https://t.me/tginfo/4430" ], "items": { "type": "string" } }, "channel": { "title": "Or: a channel to sweep", "type": "string", "description": "A channel username such as @tginfo, or its link. The actor takes that channel's most recent posts and collects the comments underneath each one. You can use this on its own or together with the list of post links above." }, "maxPosts": { "title": "How many recent posts to check", "minimum": 1, "maximum": 200, "type": "integer", "description": "Only used when you supply a channel above. The actor works back from the newest post. Posts whose comments are switched off cost almost nothing to check.", "default": 10 }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper limit on the comments collected from a single post. When a discussion is bigger than this limit, you get the most recent comments up to the limit. Busy posts can carry hundreds.", "default": 100 }, "onlyTopLevelComments": { "title": "Only top-level comments", "type": "boolean", "description": "Keep just the comments written straight to the post, and drop the ones that answer another comment. Useful when you want distinct opinions rather than back-and-forth. The per-post limit above is applied first, so a post whose newest comments are mostly replies can return only a few rows.", "default": false }, "reportPostsWithoutComments": { "title": "Report posts with no public discussion", "type": "boolean", "description": "Adds one short row for every post whose comments are switched off or no longer available, so your output shows the post was checked instead of leaving a silent gap. Switch it off to receive comment rows only.", "default": true }, "country": { "title": "Browse from", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "nl", "se", "pl", "ua", "tr", "br", "in", "sg" ], "type": "string", "description": "Which country Telegram is browsed from. Discussions read the same almost everywhere, but a few channels are restricted in some countries, so pinning this keeps repeat runs consistent.", "default": "us" }, "postsAtOnce": { "title": "Posts handled at the same time", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many posts are worked through side by side. Higher finishes a large list sooner; lower is gentler and easier to follow in the log.", "default": 5 } } }, "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 } } }, "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 } } } } } } } } } }