Telegram 頻道爬蟲｜公開頻道訊息、瀏覽數、輿情一鍵匯出（免 API）

抓 Telegram 公開頻道的網頁預覽（t.me/s/{channel}）：訊息文字、瀏覽數、轉發標記、媒體與連結旗標，走純 HTML 端點，不用登入、不用 bot token。

輸出欄位

欄位名稱	型別	說明
message_id	string	訊息 ID（頻道內遞增）
channel	string	頻道 username（讀自頁面本身的 data-post）
channel_title	string | null	頻道顯示名稱
text	string | null	訊息文字（純媒體訊息無文字時為 null；<br> 換行已轉成空格，避免段落黏在一起）
created_at	string | null	發布時間（ISO 8601 UTC）
views	number | null	瀏覽數（原始頁面可能是 "12.6M"／"1.51M"／"895" 這種格式，已轉換成整數）
author	string | null	署名作者（多數頻道以頻道身分發文，此欄位為 null；少數頻道每則訊息會顯示發文人）
is_forwarded	boolean	是否為轉發訊息
forwarded_from	string | null	轉發來源頻道／使用者名稱（非轉發時為 null）
has_media	boolean	是否含媒體（照片／影片／檔案／語音／圓形影片任一）
media_type	string | null	photo | video | document | voice | roundvideo | null
has_link_preview	boolean	是否含連結預覽卡片
links	string[]	訊息文字內的外部連結（已去重）
is_reply	boolean	是否為回覆訊息
message_url	string	訊息連結（https://t.me/{channel}/{message_id}）
source_mode	string	固定 channel
source_query	string	查詢時輸入的頻道 username
scraped_at	string	抓取時間（ISO 8601）

輸入欄位

欄位	型別	預設	說明
channels	array	["durov"]	頻道 username 或 t.me 網址，例如 durov 或 https://t.me/durov（也接受 https://t.me/s/durov）。只支援公開頻道，私人／邀請連結（joinchat、+）不支援
bulkInput	textarea	—	批量貼上，一行一個，執行時自動併入 channels
keywords	array	—	訊息文字關鍵字過濾（不分大小寫，留空不過濾）
maxItems	integer	50	每個頻道最多抓幾則訊息。上限 2000
dateFrom	string	—	依訊息發布時間過濾。格式 3d、12h、2w（相對時間）或 MM/DD/YY（絕對日期）。有設定時會提早停止翻頁，排程監控更省成本
proxyConfiguration	proxy	Apify datacenter proxy	預設開啟；不用 proxy 會與其他 run 共用出口 IP 而被限流。自備 proxy 或本機測試才關

這個 Actor 只有一種模式（抓頻道訊息），所以輸入欄位沒有 mode 選擇器——channels 直接是主要欄位，介面更單純。

輸入範例

抓單一頻道最新訊息

{
  "channels": ["durov"],
  "maxItems": 30
}

關鍵字監控 + 時間區間（排程用）

{
  "channels": ["telegram"],
  "keywords": ["update", "feature"],
  "dateFrom": "7d",
  "maxItems": 200
}

品牌與關鍵字監控

設定 keywords + dateFrom，排程每天跑一次，就是一套零維護的公開頻道輿情/品牌監控：只拿到新訊息裡符合關鍵字的部分，省成本也省後製篩選的力氣。想要更完整的社群輿情拼圖？搭配作者的其他繁中社群 actor：Threads（threads-feed-scraper）、LIHKG（lihkg-scraper，香港論壇）。三隻 actor 輸出欄位同一套慣例（snake_case、缺值 null、附 ISO 時間戳、keywords/dateFrom 篩選語法相同），方便合併分析多平台輿情。

注意事項

• 只抓公開頻道的網頁預覽版本，不需要帳號、不需要 bot token、不需要加入頻道
• 私人頻道、邀請連結（joinchat/...、t.me/+...）不支援：這類連結沒有對應的公開預覽頁，Actor 會在 log 顯示警告並略過該筆輸入
• 媒體內容（照片／影片／檔案／語音）不會下載，只會標記 has_media／media_type 這類旗標，links 欄位也只收錄訊息文字裡的外部連結，不含媒體檔案網址
• views 在原始頁面常以 "12.6M"／"1.51M"／"895" 這種格式呈現，已統一轉換成整數
• 訊息文字用 <br> 換行時已轉換成空格，避免段落黏成一團無法閱讀
• 連續 2 頁沒有新訊息會自動停止翻頁，不空轉燒費用；設了 dateFrom 的話，整頁訊息都比 dateFrom 舊就會直接停止（更省成本）
• Telegram 網頁預覽版本未來若改版，判斷方式：以 Apify cloud smoke test 結果為準（go/no-go）

常見問題（FAQ）

Q: 怎麼找頻道 username？

A: 在 Telegram App 裡打開頻道，頻道資訊頁會顯示 @username；或直接看頻道分享連結 https://t.me/{username}。把 @ 去掉貼進 channels 就可以，或整段網址貼上也行，Actor 會自動抽出 username。

Q: 私人頻道可以嗎？

A: 不行。這個 Actor 只走 Telegram 官方提供的公開網頁預覽（t.me/s/{channel}），私人頻道沒有這個頁面，貼邀請連結（joinchat／+）會被自動略過並在 log 顯示警告，不會被計費。

Q: author 欄位為什麼常常是 null？

A: 多數頻道是以「頻道」身分發文，不會顯示個別發文人；只有少數頻道（多半是使用群組管理身分發文，或是個人頻道如本 README 範例的 durov）每則訊息才會顯示署名，這類頻道的 author 會有值。誠實回傳 null，不做假資料。

Q: 可以同時抓多個頻道嗎？

A: 可以。在 channels 填多個 username，或用 bulkInput 一行一個貼上。

免責聲明

本工具僅供學術研究及合法商業分析用途。使用者應遵守 Telegram 服務條款及相關法規。請勿以本工具進行任何侵害他人隱私、散布虛假資訊或其他違法行為。作者不對任何濫用行為承擔責任。

---

Telegram 爬蟲、Telegram channel scraper、頻道訊息、公開頻道、社群輿情、品牌監控、message monitoring