メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

このガイドでは、2006年3月までさかのぼる完全な X アーカイブから投稿を検索するために、最初のフルアーカイブ検索リクエストを実行する手順を順を追って説明します。
フルアーカイブ検索を利用するには、セルフサービスまたはエンタープライズアクセスが必要です。このエンドポイントを使用するには、アクセスをアップグレードしてください。
前提条件作業を始める前に、次のものが必要です。
  • 開発者アカウント
  • App のベアラートークン (開発者コンソールの「Keys and tokens」で確認できます)

​
ステップ 1: クエリを作成する

Full-archive search では、すべてのクエリオペレーターを利用できます。recent search と同じ要領でクエリを作成してください。 
from:XDevelopers lang:en
フルアーカイブ検索は、最大 1,024 文字までのクエリをサポートします (Enterprise では 4,096 文字) 。

​
ステップ 2: 時間範囲を設定する

デフォルトでは、直近30日間の投稿が結果として返されます。特定の期間を指定して検索するには、start_time と end_time を使用します。
ParameterFormatExample
start_timeISO 86012020-01-01T00:00:00Z
end_timeISO 86012020-12-31T23:59:59Z

​
ステップ 3: リクエストを送信する

cURL
curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
ステップ 4：レスポンスを確認する

{
  "data": [
    {
      "id": "1271111223220809728",
      "text": "Tune in tonight and watch as @jessicagarson takes us through...",
      "edit_history_tweet_ids": ["1271111223220809728"]
    },
    {
      "id": "1270799243071062016",
      "text": "As we work towards building the new Twitter API...",
      "edit_history_tweet_ids": ["1270799243071062016"]
    }
  ],
  "meta": {
    "newest_id": "1271111223220809728",
    "oldest_id": "1270799243071062016",
    "result_count": 2
  }
}
編集機能が導入される前 (2022年9月) に作成された投稿には、edit_history_tweet_ids は含まれません。

​
ステップ 5: フィールドとexpansionsを追加する

クエリパラメータを使用して追加のデータをリクエストします:
cURL
curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,description&\
max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
ステップ 6: 結果をページングする

SDK ではページングを自動的に処理します。cURL を使用する場合は、レスポンス内の next_token を使用します。 
curl "https://api.x.com/2/tweets/search/all?\
query=from%3AXDevelopers&\
max_results=500&\
next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
  -H "Authorization: Bearer $BEARER_TOKEN"

ページネーションガイド

大規模な結果セットをページング処理する方法について詳しく学びましょう
機能Recent SearchFull-Archive Search
期間過去7日間2006年3月から現在まで
必要なアクセス権限すべての開発者従量課金、Enterprise
リクエストあたりの最大取得件数100500
クエリ長512文字1,024文字
レート制限450 / 15分300 / 15分, 1 / 秒
認証方式App-Only、User ContextApp-Only のみ

​
共通パラメーター

Parameter説明デフォルト
query検索クエリ (必須)—
max_results1ページあたりの投稿数 (10〜500)10
start_time最も古いポストのタイムスタンプ30日前
end_time最も新しいポストのタイムスタンプ現在
next_tokenページネーション用トークン—
tweet.fields追加で取得するポストのフィールドid, text
expansionsレスポンスに含める関連オブジェクト—

​
次のステップ

クエリを構築する

クエリ構文と演算子を習得する

演算子リファレンス

利用可能なすべての演算子を確認する

ページネーションガイド

大量の結果セットを処理する

APIリファレンス

エンドポイントの詳細ドキュメント