{
  "openapi": "3.0.1",
  "info": {
    "title": "Telegram Channel Scraper — New Posts & Google Sheets",
    "description": "Monitor public Telegram channels or export a date range with saved progress. Collect posts, reactions and channel data, with spending limits and status reports. Send results to Google Sheets using our free n8n workflow. No Telegram login required.",
    "version": "0.4",
    "x-build-id": "c7bxTaAQpWj7EaY1R"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/humming_cobalt~telegram-channel-watch/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-humming_cobalt-telegram-channel-watch",
        "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/humming_cobalt~telegram-channel-watch/runs": {
      "post": {
        "operationId": "runs-sync-humming_cobalt-telegram-channel-watch",
        "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/humming_cobalt~telegram-channel-watch/run-sync": {
      "post": {
        "operationId": "run-sync-humming_cobalt-telegram-channel-watch",
        "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": "Public channels",
            "maxItems": 10,
            "type": "array",
            "description": "1–10 public channel usernames, @handles, or t.me channel links. The prefilled news channel is a sample; replace it with your own sources. No private invites, groups, or individual post links.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Collection mode",
            "enum": [
              "monitor",
              "history"
            ],
            "type": "string",
            "description": "Monitor continues from saved positions. History exports a fixed date range with separate progress; repeat the same input to resume.",
            "default": "monitor"
          },
          "monitorId": {
            "title": "Monitor / export ID",
            "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,49}$",
            "type": "string",
            "description": "Reuse this ID to resume. Monitor and History progress are separate, even with the same ID. Use a new ID for changed filters or a different historical date range.",
            "default": "main"
          },
          "firstRunMode": {
            "title": "On the first run",
            "enum": [
              "recent",
              "from_now"
            ],
            "type": "string",
            "description": "For Monitor mode only. Recent collects the first-run lookback; From now saves a starting position. In History mode leave this at Recent.",
            "default": "recent"
          },
          "initialLookbackHours": {
            "title": "First-run lookback (hours)",
            "minimum": 1,
            "maximum": 8760,
            "type": "integer",
            "description": "For Monitor mode with Recent selected only. History mode uses its explicit start and end dates.",
            "default": 24
          },
          "keywords": {
            "title": "Optional keywords",
            "type": "array",
            "description": "Return posts containing any of these phrases (case-insensitive substring match). Empty means all posts. Use a new monitor ID if you change the keywords.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxPostsPerChannel": {
            "title": "Maximum posts per channel per run",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Unfinished work is saved for the next run. The report says CATCHING_UP until the backlog is complete.",
            "default": 100
          },
          "maxPagesPerChannel": {
            "title": "Maximum pages per channel per run",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Up to 10 pages per channel. Across the run: at most 20 source requests including retries, 10 MiB of source data, and 90 seconds of collection work. Unfinished work resumes on the next run.",
            "default": 10
          },
          "requestDelayMs": {
            "title": "Delay between requests (milliseconds)",
            "minimum": 250,
            "maximum": 10000,
            "type": "integer",
            "description": "Conservative pacing. Temporary errors and rate limits are retried with additional delays.",
            "default": 600
          },
          "maxChargeUsd": {
            "title": "Event spending limit per run (USD)",
            "minimum": 0.01,
            "maximum": 100,
            "type": "number",
            "description": "Limit this run’s Actor event charges, including the start fee. The lower of this and Apify’s maximum cost applies. The platform start fee applies even to empty or failed starts.",
            "default": 0.2
          },
          "fromDate": {
            "title": "History: start date (inclusive)",
            "type": "string",
            "description": "Required in History mode. YYYY-MM-DD means midnight UTC; or use an ISO timestamp with timezone. Example: 2026-10-01."
          },
          "toDate": {
            "title": "History: end date (exclusive)",
            "type": "string",
            "description": "Required in History mode. To include all of 1 October use 2026-10-02. A completed export does not refresh later edits or posts; use a new ID for a new snapshot."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}