Twitter API

Twitter API：使用者查詢、時間軸與分頁

透過 Bearer 驗證、使用者及推文欄位選擇、游標分頁與驗證錯誤處理，整合 API Hop Twitter / X 端點。

將使用者名稱解析為使用者 ID，取得時間軸，再以回傳的下一頁 token 請求其他頁面。成功呼叫直接回傳 JSON；這些端點不需要 Jobs 輪詢。

取得 API 金鑰瀏覽 API 目錄

針對特定任務

實作三個支援的 GET 操作並處理結果。

依使用者名稱查詢帳戶，並選擇要回傳的個人資料欄位。

依使用者 ID 更新已知帳戶，無須再次查詢使用者名稱。

使用每頁數量上限及分頁 token 取得時間軸頁面。

計費單位

了解用量計算方式

每次請求以美元計費。

運作限制

回傳欄位依文件定義的查詢參數及上游回應而定。
max_results 必須是 1 至 100 的整數。每頁可能回傳更少結果。
請以字串保留使用者 ID 及推文 ID，避免數值精度損失。

整合指南

選擇下一步

規劃更新及儲存 請在應用程式中限制請求次數、去除重複貼文並記錄擷取時間。 資料 API 目錄 查看目前資料產品、操作及按請求計算的價格。

目前目錄涵蓋範圍

可用 API 及計費單位

比較 API ID、操作、供應商與價格。估算用量費用前，請檢查目錄日期及各操作的計費單位。

資料 API

Twitter User Data

twitter-user-data 文件

可用

取得公開的 Twitter / X 使用者資料與使用者時間軸。

供應商: Twitter / X Data
計費單位: 請求
API 格式與端點: 請求端點請見下方操作。
公開能力: 使用者查詢, 使用者時間軸

公開操作

GET /v1/twitter/users 依使用者名稱取得使用者
GET /v1/twitter/users/{id} 依使用者 ID 取得使用者
GET /v1/twitter/users/{id}/tweets 取得使用者推文

API Hop 價格

請求: $0.0020 /請求

依使用者名稱取得使用者

GET /v1/twitter/users

API Hop 價格

請求: $0.0020 /請求

依使用者 ID 取得使用者

GET /v1/twitter/users/{id}

API Hop 價格

請求: $0.0020 /請求

取得使用者推文

GET /v1/twitter/users/{id}/tweets

API Hop 價格

請求: $0.0020 /請求

開啟完整 API 目錄

請求範例

從文件定義的操作開始

curl "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics" \
  -H "Authorization: Bearer <API_KEY>"

const response = await fetch("https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics", {
  headers: { Authorization: "Bearer <API_KEY>" }
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.apihop.ai/v1/twitter/users?username=OpenAI&user.fields=description,public_metrics"
headers = {"Authorization": "Bearer <API_KEY>"}
response = requests.get(url, headers=headers, timeout=60)
response.raise_for_status()
print(response.json())

請使用帳戶文件的 API 基礎 URL 並替換範例預留位置。API 金鑰透過 Authorization 標頭傳送，切勿放入 URL 或提交的檔案。

端點

帳戶與時間軸的三個操作

依使用者名稱查詢 GET /v1/twitter/users?username=<USERNAME>

將回傳的 data.id 作為字串讀取，供後續請求使用。

依使用者 ID 查詢 GET /v1/twitter/users/<USER_ID>

取得已知帳戶，並視需要選擇個人資料欄位。

使用者時間軸 GET /v1/twitter/users/<USER_ID>/tweets

設定 max_results，並傳入 pagination_token 以取得後續頁面。

查詢參數

選擇欄位並對時間軸分頁

帳戶查詢: /v1/twitter/users 必須提供 username。兩個查詢端點均接受以逗號分隔的 user.fields 清單，例如 description,public_metrics。
每頁數量: max_results 接受 1 至 100 的整數。這是每頁數量上限，不保證回傳同等數量的貼文。
時間軸欄位: 使用 tweet.fields=created_at,public_metrics 取得時間戳及指標。需要可用作者資訊時，請搭配 user.fields 請求 expansions=author_id。使用 exclude=replies,retweets 排除這些貼文類型。
下一頁: 將回應的 meta.next_token 作為下一次請求的 pagination_token。請將 token 視為不透明值並進行 URL 編碼。未回傳下一頁 token、達到頁數預算或 token 重複時，請停止。

回應處理

直接讀取 JSON 結果

使用者查詢在 data 回傳帳戶。時間軸回應包含 data 陣列和 meta.result_count，有下一個游標時另含 meta.next_token。作者擴充資訊可能出現在 includes.users。

{
  "data": [],
  "meta": {
    "result_count": 0
  }
}

這是空時間軸回應範例，並非即時帳戶結果。可選欄位及游標可能不存在。空頁面不能證明帳戶從未發文。

驗證錯誤

重試前修正無效參數

缺少 username 或 max_results 超出範圍時，會回傳 HTTP 400，並含 success: false、error.code: 10001、error.message 及 requestId。請檢查訊息並修正請求，不要原樣重試。

請求追蹤

保留請求 ID，而非憑證

保留 X-Request-Id 回應標頭，以便支援及追蹤請求。讀取成功資料前請先檢查 HTTP 狀態；勿在應用程式紀錄中保存 API 金鑰及不必要的個人資料。