{
  "openapi": "3.0.1",
  "info": {
    "title": "Telegram Keyword Search Scraper - Mention Alerts, No Login",
    "description": "Search public Telegram channels for any keyword from $1.50 per 1,000 matching posts - finds recent posts Google hasn't indexed, exact-phrase matching, only-new mode for mention alerts. No login or API key; posts that don't match are free.",
    "version": "0.1",
    "x-build-id": "uWMq0PNHKGuAC0Sw6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/datalume~telegram-keyword-search-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-datalume-telegram-keyword-search-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/datalume~telegram-keyword-search-scraper/runs": {
      "post": {
        "operationId": "runs-sync-datalume-telegram-keyword-search-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/datalume~telegram-keyword-search-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-datalume-telegram-keyword-search-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": [
          "keywords"
        ],
        "properties": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Words or phrases to find in public Telegram channels, e.g. a brand, coin, product or person. Each keyword is searched separately; phrases like bitcoin ETF are matched as a whole phrase by default.",
            "items": {
              "type": "string"
            }
          },
          "discoverChannels": {
            "title": "Find channels automatically",
            "type": "boolean",
            "description": "Find public channels that talk about each keyword using Google (site:t.me), then search inside them. If Google returns few channels, channels that matching posts were forwarded from or link to are searched too. Charged once per keyword only when Google is searched and at least one channel is found; found channels are reused for 24 hours.",
            "default": true
          },
          "channels": {
            "title": "Channels to search",
            "type": "array",
            "description": "Optional. Public channels that are always searched for every keyword: username, @username or t.me link. Use this alone (with automatic finding turned off) to search only your own channel list.",
            "items": {
              "type": "string"
            }
          },
          "maxChannelsPerKeyword": {
            "title": "Max channels found per keyword",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many automatically found channels (Google + channels found in matching posts) are searched for each keyword. Your own channels are always searched.",
            "default": 10
          },
          "matchMode": {
            "title": "Match",
            "enum": [
              "phrase",
              "allWords",
              "telegram"
            ],
            "type": "string",
            "description": "Telegram's own search also returns posts where the words appear separately. 'Exact phrase' keeps only posts that contain the keyword as written (case-insensitive) or as a #hashtag. Every row says how it matched in matchType.",
            "default": "phrase"
          },
          "maxPostsPerKeyword": {
            "title": "Max posts per keyword",
            "minimum": 0,
            "type": "integer",
            "description": "Stop collecting a keyword after this many matching posts. 0 = no limit.",
            "default": 100
          },
          "maxPostsPerChannel": {
            "title": "Max posts per channel",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Matching posts per channel and keyword. Newest posts come first.",
            "default": 50
          },
          "dateFrom": {
            "title": "Posts from",
            "type": "string",
            "description": "Optional. A date (2026-11-01) or a period like '7 days', '2 weeks', '24 hours'."
          },
          "dateTo": {
            "title": "Posts until",
            "type": "string",
            "description": "Optional. A date (2026-11-15) or a period like '1 day'."
          },
          "onlyNewPosts": {
            "title": "Only new posts (mention alerts)",
            "type": "boolean",
            "description": "Return only posts published since the previous run of this keyword in each channel. Schedule the Actor (e.g. every hour) to get a feed of new mentions and pay only for what is new.",
            "default": false
          },
          "includeChannelInfo": {
            "title": "Add channel details to every row",
            "type": "boolean",
            "description": "Channel description, verified badge, photo and counters in a channelInfo field.",
            "default": false
          },
          "discoveryCacheHours": {
            "title": "Reuse found channels for (hours)",
            "minimum": 0,
            "maximum": 720,
            "type": "integer",
            "description": "Channels found on Google for a keyword are reused for this many hours, so scheduled runs search Google (and charge keyword discovery) at most once per period. 0 = search Google on every run.",
            "default": 24
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed in most cases. If Telegram slows the run down, it switches to Apify datacenter proxy automatically.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}