StockTwits 爬蟲｜美股社群輿情、熱門標的一鍵下載（免 API、免登入）

一個 Actor 搞定 StockTwits 兩種你會用到的抓取模式：個股討論串（依股票代號拿社群貼文、bullish/bearish 情緒標籤、用戶資訊）與熱門標的榜（拿當下最多人討論的股票與加密幣排行）。不需要登入、不需要 API token、批量貼上股票代號都吃得下。全程走 StockTwits 公開 JSON API，不開瀏覽器，速度快、成本低。

給誰用的：量化研究員、meme-stock 監控工程師、情緒因子開發者、財經 side project 作者、學術論文需要社群情緒資料集的研究者。

---

能抓到什麼

symbol 模式 — 個股貼文

每一則討論都會拿到下面這些欄位（缺值一律回 null，不會少欄位）：

欄位	說明	範例
message_id	貼文 ID	654321
symbol	查詢時指定的股票代號	AAPL
symbols_mentioned	貼文中提到的所有標的代號	["AAPL", "MSFT"]
body	貼文內容	$AAPL breaking out of the wedge 🚀
sentiment	情緒標籤	Bullish、Bearish、null（未標記）
user_id	用戶 ID	987654
username	用戶名	trader_joe
user_followers	粉絲數	1205
likes_count	讚數	42
source_app	發文用的應用程式	StockTwits Web
message_created_at	發文時間（ISO 8601）	2026-07-04T08:23:11.000Z
message_url	貼文網址	https://stocktwits.com/trader_joe/message/654321
source_mode	來源模式	symbol
source_query	查詢時用的股票代號	AAPL
scraped_at	抓取當下時間（ISO 8601）	2026-07-04T08:30:00.000Z

trending 模式 — 熱門標的榜

欄位	說明	範例
symbol	股票/加密幣代號	NVDA
symbol_title	標的全名	NVIDIA Corp.
exchange	上市交易所	NASDAQ
watchlist_count	追蹤人數	348721
instrument_class	標的類型	Equity、Cryptocurrency
trending_score	熱度分數（相對值）	0.842
source_mode	來源模式	trending
source_query	查詢條件（固定值）	trending
scraped_at	抓取當下時間（ISO 8601）	2026-07-04T08:30:00.000Z

---

兩種模式一個爬蟲

模式	幹嘛用的	計費事件	單價
📈 symbol	依股票代號抓個股討論串（含 bullish/bearish 情緒標籤）	search-listing（每則貼文）	$0.002
🔥 trending	抓 StockTwits 當下熱門標的清單（股票＋加密幣混合）	search-listing（每個標的）	$0.002

不管跑哪個模式，每次 Run 啟動都會額外收一次性的 actor-start 費用 $0.005。所有計費都在資料成功寫入 dataset 之後才會收，Run 結束時 log 會印出 total_items / charged / skipped 讓你對帳。

---

輸入欄位

欄位	型別	必填	預設	說明
mode	enum	建議填	自動偵測	symbol（個股討論串）/ trending（熱門標的榜）擇一。留空時若有填 symbols 自動切 symbol 模式，否則切 trending 模式。
symbols	string[]	symbol 模式必填	—	股票代號，例如 AAPL、TSLA、NVDA。大小寫不限，自動轉大寫。單次最多 100 個。
bulkInput	string	選填	—	一行一個股票代號，按 Enter 換行，不要加引號或逗號。執行時自動併入 symbols 欄位。從 Google Sheet / Excel 複製一整欄貼進來最快。trending 模式此欄位無效。
maxItems	integer	選填	50	每個股票代號（symbol 模式）或整個 trending 榜最多回傳幾筆（1-500）。
proxyConfiguration	object	選填	不用 proxy	預設直連，通常不用設定。大量抓取遇到 429 才建議開啟 Apify Proxy。

---

範例

📈 抓多檔個股討論串

{
    "mode": "symbol",
    "symbols": ["AAPL", "TSLA", "NVDA"],
    "maxItems": 30
}

📋 批量貼入股票代號（bulkInput）

{
    "mode": "symbol",
    "bulkInput": "AAPL\nTSLA\nNVDA\nAMD\nMSFT",
    "maxItems": 20
}

🔥 抓熱門標的榜（trending）

{
    "mode": "trending",
    "maxItems": 50
}

---

計費說明

每次 Run 固定收 actor-start（$0.005）一次。此後每筆成功寫入 dataset 的資料收 search-listing（$0.002）——不管是 symbol 模式的個別貼文還是 trending 模式的標的都是同一單價。抓 50 筆的最低費用：$0.005 + 50 × $0.002 = $0.105。Run 結束時 log 印出 total_items / charged / skipped，可直接對帳。

---

幾個要注意的地方

• 只抓公開資料。不需要登入、不需要 StockTwits 帳號，也不會存取任何需要驗證才看得到的內容。
• 免 API token。填好 input 就能跑，沒有任何金鑰要設定。
• trending 模式不用填 symbols。直接把 mode 設為 trending、填 maxItems 就好，symbols 欄位留空即可。
• symbols 大小寫不限。填 aapl 跟 AAPL 結果一樣，程式自動轉大寫並去重複。
• 對 StockTwits 伺服器友善。每個 domain 併發數 ≤5，遇到失敗會用指數退避重試最多 3 次。連續 5 頁拿不到新資料就會自己停並在 log 寫原因，不會空轉燒錢。
• sentiment 欄位可能為 null。StockTwits 情緒標籤是用戶自行選填，大部分貼文不會標記，null 是正常值。
• 同一則貼文若一次 Run 中被重複爬到，會去重複只保留一筆（依 message_id 去重）。

---

常見問題

Q: trending 模式會抓到加密幣嗎？ 會。StockTwits trending 榜混合股票與加密幣，可以用 instrument_class 欄位（Equity vs Cryptocurrency）區分。

Q: symbol 模式翻頁怎麼停？ 兩個條件任一滿足就停：(1) 已達 maxItems；(2) 連續 5 頁都沒有新貼文（stale 停止）。

Q: 費用怎麼算？ 每次 Run 啟動收 actor-start（$0.005）；之後每筆資料收 search-listing（$0.002）。資料成功寫入 dataset 後才收費，Run log 印出實際收費筆數。

Q: 抓不到資料怎麼辦？ 先確認股票代號有無打錯（StockTwits 只支援有在平台上出現過的代號），或直接切 trending 模式確認服務正常。若連 trending 也空回應，可能是 StockTwits 短暫限流，等一會兒再試。

Q: 能抓情緒統計（多空比）嗎？ v1.0 只回原始貼文資料，多空比統計（sentiment aggregation）規劃在 v1.1 加入。你可以自行用 Python/Excel 對 sentiment 欄位做統計。

---

部署

apify login              # 首次：貼上 Apify token（不會寫進 repo）
apify push               # 建置並上傳到 Apify Store

上架後在 Apify Console 的 Monetization 設定 PPE 事件單價： actor-start $0.005、search-listing $0.002。

---

免責聲明

本爬蟲只收集 StockTwits 公開可見的社群資料，資料僅供研究與個人用途使用，不用於任何未經授權的商業轉售。使用前請自行確認符合 StockTwits 服務條款與當地法規。對於資料的正確性、即時性或完整性，本 Actor 不做任何保證，投資決策請以正規財務資訊管道為準，本 Actor 產出的社群輿情資料不構成任何投資建議。

---

StockTwits 爬蟲、stocktwits API、美股輿情、社群情緒、bullish bearish、meme stock 監控、trending stocks、加密幣討論、量化因子、選股輿情