{
  "openapi": "3.0.1",
  "info": {
    "title": "Telegram Channel Scraper: Posts, Views & Reactions, No Login",
    "description": "Scrape public Telegram channels via their t.me/s web preview. No login or API key. Posts, views, reactions and media. No comments, no Telegram-wide search.",
    "version": "0.1",
    "x-build-id": "xPUdgW1ILY5tbV6P1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dataizi-srl~telegram-channel-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dataizi-srl-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/dataizi-srl~telegram-channel-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dataizi-srl-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/dataizi-srl~telegram-channel-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dataizi-srl-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 Telegram channels to read, one per line. Write a username (`telegram`), an @handle (`@durov`) or a link (`https://t.me/telegram`). A link to one post (`https://t.me/telegram/123`) starts at that post and goes back in time. Public channels only: private channels, groups and users are not supported.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "What to extract",
            "enum": [
              "posts",
              "channels"
            ],
            "type": "string",
            "description": "Posts: one row per post, with the channel's title and counts on every row. Channels: one row per channel, with its exact subscriber count and profile details. The filters below are ignored in Channels mode. One run returns one kind of row.",
            "default": "posts"
          },
          "maxPostsPerChannel": {
            "title": "Posts per channel",
            "minimum": 0,
            "type": "integer",
            "description": "How many of the newest posts to read from each channel. Enter 0 for no per-channel cap: the run then reads back to the channel's first post, or until a limit stops it (Maximum rows in total, your spending limit or the run timeout). Very large channels need a longer run timeout. Ignored in Channels mode, and when \"New posts since the last run\" has a saved starting point (the run then reads every newer post).",
            "default": 20
          },
          "maxItems": {
            "title": "Maximum rows in total",
            "minimum": 0,
            "type": "integer",
            "description": "Stops the whole run after this many rows, across all channels. The default of 100 keeps a first run small; enter 0 for no total limit. Your spending limit still applies. Raise it, or enter 0, when you read many channels or many posts per channel.",
            "default": 100
          },
          "oldestPostDate": {
            "title": "Posts from this date",
            "type": "string",
            "description": "Skip posts published before this date. Use a date such as `2026-10-01`, or a relative time such as `7 days`, `3 weeks`, `1 month` or `1 year`, counted back from the start of the run. Times are UTC. Ignored in Channels mode."
          },
          "newestPostDate": {
            "title": "Posts up to this date",
            "type": "string",
            "description": "Skip posts published after this date. A plain date includes that whole day, so `2026-10-01` to `2026-10-31` gives October. Relative times such as `3 weeks` work too. It must not be earlier than \"Posts from this date\". Ignored in Channels mode."
          },
          "searchText": {
            "title": "Search inside channels",
            "type": "string",
            "description": "Return posts that match this word, phrase or hashtag (such as `#news`), using Telegram's own search inside each channel you listed. It searches those channels, not all of Telegram. Leave empty to read every post. Ignored in Channels mode."
          },
          "onlyNewSinceLastRun": {
            "title": "New posts since the last run",
            "type": "boolean",
            "description": "Remembers where each channel's last run stopped and returns just the newer posts next time. Use it in a saved task you run on a schedule: each task keeps its own starting points. The first run has no starting point, so it reads the latest posts up to \"Posts per channel\". The starting point moves forward only after a run has reached the previous one, so a run cut short does not make later runs skip posts. The date filters above still apply. A run with nothing new ends successfully with no rows. Ignored in Channels mode.",
            "default": false
          },
          "includePersonalData": {
            "title": "Include personal data",
            "type": "boolean",
            "description": "On by default, because every field the preview shows is included. Untick it to set 10 person-level columns to empty (`null`): author and signature names, forwarded-from and replied-to names, the forwarded-from link, bot names, post authors' pictures, and channel pictures and profile titles. Post and description text stay in, since they can mention people. You are responsible for having a lawful basis (for example under the GDPR) for the data you collect.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Off by default. Switch on Apify Proxy if Telegram blocks your runs. Residential groups, Google SERP groups and custom proxy URLs are not supported: the run stops before reading anything.",
            "default": {
              "useApifyProxy": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}