ZH
開始使用

Facebook · Events

Facebook活動搜尋爬蟲 API

Facebook活動搜尋端點就是一次 API 呼叫:帶著你的 HProxy 金鑰送出搜尋查詢,就會取回乾淨的結構化 JSON 物件。依關鍵字搜尋 Facebook 活動,取回排序後的結果,附標題、場地、開始時間和參加人數。HProxy 在伺服器端處理代理、工作階段、反機器人和解析,所以不必照顧無頭瀏覽器,Facebook改版時也不必一直修解析器。你只需要處理 JSON。較長的結果集會以游標分頁回傳,所以你可以走完整個結果集,不必全部放在記憶體中。
取得你的 API 金鑰Facebook API 參考文件
  • 每次 0.15¢
  • 每 1,000 次 US$ 1.49
  • 需要搜尋查詢
  • 錯誤和逾時不收費

這個呼叫

一個 GET,活動搜尋就會以 JSON 回傳。

你的金鑰放在一個標頭中。1 required parameter, and the answer is the object below it.

完整參考文件
curl "https://hproxy.com/api/v1/scrape/facebook/events-search?query=coffee" \
  -H "X-API-Key: hpx_your_key_here"
回應200 OK · JSON
{
  "events": [
    { "id": "88120...", "title": "Launch night", "startTime": "2026-08-14T18:00:00Z",
      "venue": { "name": "The Hall", "city": "Berlin" },
      "attendance": { "going": 412, "interested": 1890 } }
  ]
}

回傳的內容

Facebook活動搜尋物件。

events[]
每個活動附標題、說明和封面圖。
startTime / endTime
排定的開始和結束時間,附時區。
venue
公開時提供地點名稱、地址和座標。
attendance
參加和有興趣人數。

需要什麼

Parameters.

querystringRequiredcoffee

搜尋詞或關鍵字。

cursorstring0

來自上一個回應的分頁權杖。

運作方式

爬取Facebook活動搜尋,只要三個步驟。

你只要寫一行。代理、反機器人機制、渲染和解析都在我們這邊完成。

  1. 1

    建立免費帳號

    註冊並儲值任意金額。餘額可支付每一項 HProxy 產品。
  2. 2

    取得你的 API 金鑰

    儀表板上的一把金鑰就能驗證每個爬蟲。
  3. 3

    呼叫端點

    發送你需要的 GET,讀取 JSON。整合就這麼簡單。

大家用它做什麼

Facebook活動搜尋端點最能發揮價值的地方。

  • 把一個城市正在發生的事彙整到你自己的活動清單。
  • 自動追蹤競爭對手和社群的活動。
  • 有符合主題或場地的新活動時發出提醒。

Facebook活動搜尋常見問題

你還沒問,我們就先回答了。

參考文件

帶著搜尋查詢和你的 HProxy API 金鑰,向Facebook活動搜尋端點發送一個經過驗證的 HTTPS 請求。依關鍵字搜尋 Facebook 活動,取回排序後的結果,附標題、場地、開始時間和參加人數。你這邊不需要代理、無頭瀏覽器或解析。回應就是可直接使用的 JSON。

這個端點每次成功呼叫 0.15¢,也就是每 1,000 次 US$ 1.49。從你的 HProxy 餘額扣款,不需訂閱,也沒有每月最低消費。錯誤會重試,而且從不收費;查詢的目標不存在時仍算一次呼叫。

不需要。每次呼叫都在幕後使用 HProxy 自己的住宅網路執行,所以請求看起來像真實使用者。代理這一層已經包含在每次呼叫的價格中。

包含Facebook公開提供的完整活動搜尋資料的結構化 JSON 物件。請見上方列出的欄位。每次呼叫的結構都一致,所以只要整合一次就能依賴它。

可以。回應附有游標;在下一次呼叫時傳回去,就能從上次停下的地方繼續。每一頁是一次計費的呼叫,所以你只需為實際取得的深度付費。

這個 API 只存取公開可得的Facebook資料,也就是任何人都能在瀏覽器中打開的同一批頁面。依你的用途,你有責任依照適用法律和Facebook的條款使用這些資料。

文件與 AI

隨時把你的爬蟲連接到 AI。

整個爬蟲 API 都以 Markdown 發布,因此 AI 助理不需要金鑰,就能讀取每個端點、每個參數與一份真實回應,並幫你寫好整合程式。而且由於每次爬取都是一個以 JSON 回應的 GET,代理程式可以用你的金鑰,依照自己的排程自行執行爬蟲。

閱讀爬蟲文件設定你的 AI 助理

Claude、ChatGPT、Cursor、Gemini、Copilot、Windsurf、Perplexity、Ollama,以及任何支援 MCP 的助理。

AI 代理程式可以呼叫它

用你的金鑰發一個 GET,就能取得結構化的 JSON,代理程式可以依照自己的排程爬取。沒有瀏覽器要操控,也沒有解析器要在每次執行之間維護。

查看端點

MCP 伺服器與 CLI

由我們為免費工具打造並架設在 mcp.hproxy.com:代理清單、檢測工具與 IP 查詢,以工具形式出現在 Claude、ChatGPT、Cursor 或任何支援 MCP 的 AI 助理中。無須安裝,不需要金鑰。

新增到你的 AI 助理

API 文件

每個爬蟲端點都有完整文件,包含它接受的參數與它實際傳回的回應。

閱讀文件

其他平台上的活動

另外 1 個platform上也有相同的資料。

一把金鑰,一種 JSON 形狀,一個餘額。換到其他平台,也不必學第二套 API。

Event爬蟲 API

更多關於Facebook活動搜尋 API

Facebook 活動搜尋 端點會回傳什麼

依關鍵字搜尋 Facebook 活動,取回排序後的結果,附標題、場地、開始時間和參加人數。 JSON 物件包含 events[], startTime / endTime, venue和attendance。 我們這邊不會摘要刪減任何內容,所以你在回應中讀到的,就是 Facebook 活動搜尋 頁面本身的內容。

你要傳給 Facebook 活動搜尋 API 的內容

呼叫需要 搜尋查詢。 必填:query。 選填:cursor。 金鑰放在 X-API-Key 標頭中傳送,回應是 JSON,每次呼叫收費 0.15¢,也就是每 1,000 次 US$ 1.49。

其他平台上的活動

同樣的 活動 資料也能在另外 1 個平台取得:Twitch 使用者排程。 它們與這個端點共用相同的 JSON 結構、按次計費與你的同一把 API 金鑰,所以從 Facebook 換到另一個網路只要換網址,不必再做一次整合。

爬取Facebook活動搜尋是允許的嗎?

這個端點讀取公開可得的Facebook資料,也就是任何人不登入就能在瀏覽器中打開的同一批頁面。它不會碰私人帳號或任何需要密碼的內容。之後如何使用這些資料,由你依照適用於你和Facebook的規定確保合法。

隨時為你準備好。

你的控制台只要十秒就到。不用業務電話,免訂閱,沒有最低金額。