Felo API PlatformFelo API Platform

Felo X 使用者個人檔案

供應商：Felo · 以平台餘額付款

驗證與設定計費與錯誤完整工作流程指南

請選擇你需要資料所對應的操作。這五個端點都使用 POST，並且在 JSON 根層回傳，不使用共通的 data 包裝層。

所有範例都使用來自總覽的 FELO_API_KEY。呼叫會使用 平台餘額，不是 Felo Pro 點數。回應範例僅供說明；實際內容與可選欄位會有所不同。

1. 取得使用者個人檔案

POST /api/v1/data/x/user/info

欄位類型必填意義
usernamesstring array是1–100 個使用者名稱；請傳送不含 @ 的帳號
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/x/user/info" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["OpenAI"]}'

回應包含 users 與 total。每位使用者都包含 user_id、username 與 display_name；也可能包含個人檔案文字、追蹤者數、驗證狀態及其他中繼資料。一批請求回傳的個人檔案數量可能少於要求值。請依 username 或 ID 配對，不要依陣列位置。

{"users":[{"user_id":"example-user-id","username":"example","display_name":"Example"}],"total":1}

分頁與成本控制

total 會計算目前回應中的對應陣列：對貼文查詢而言是頂層貼文，對回覆查詢而言則是每個結果項目內的回覆。它不是全域比對數、貼文的完整回覆總數，或最終可計費數量。

  1. 先送出不含 cursor 的第一個請求。
  2. 從回應讀取 has_next 與 next_cursor。對回覆而言，請在每個結果項目上分別讀取。
  3. 如果還有下一頁且 cursor 非空，請以相同查詢原樣送出。對回覆批次而言，請分別繼續每個貼文。
  4. 當沒有下一頁、cursor 重複，或你自己的頁面／支出上限已達到時就停止。

分頁中繼資料反映的是最後一個上游回應；回傳的集合可能在結果上限處被截斷。即使 has_next=false，也不能保證所有 X 歷史或回覆都已擷取。請顯示實際回傳數量，不要把有上限的結果集標示為所有可用資料。

每個成功頁面都可能產生費用。這五個操作依回傳結果計費，而不是固定請求費。巢狀回覆與其他回傳記錄都可能影響計費數量；不要只根據頂層陣列長度估算成本。請查看目前價格與控制台中的用量。完整物件欄位請參閱 OpenAPI schema。

需要協助嗎？