Full-Archive Search クイックスタート

このガイドでは、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 を使用します。

Parameter	Format	Example
`start_time`	ISO 8601	`2020-01-01T00:00:00Z`
`end_time`	ISO 8601	`2020-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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# ページネーションを用いたフルアーカイブ検索
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    max_results=100
):
    for post in page.data:
        print(post.text)

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// ページネーションを用いたフルアーカイブ検索
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(post.text);
  });
}

ステップ 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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# フィールドとexpansionsを指定して検索
for page in client.posts.search_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "description"],
    max_results=100
):
    for post in page.data:
        print(f"{post.created_at}: {post.text[:50]}...")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// フィールドとexpansionsを指定して検索
const paginator = client.posts.searchAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "description"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((post) => {
    console.log(`${post.created_at}: ${post.text?.slice(0, 50)}...`);
  });
}

ステップ 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 Search との主な違い

機能	Recent Search	Full-Archive Search
期間	過去7日間	2006年3月から現在まで
必要なアクセス権限	すべての開発者	従量課金、Enterprise
リクエストあたりの最大取得件数	100	500
クエリ長	512文字	1,024文字
レート制限	450 / 15分	300 / 15分, 1 / 秒
認証方式	App-Only、User Context	App-Only のみ

共通パラメーター

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

次のステップ

クエリを構築する

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

演算子リファレンス

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

ページネーションガイド

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

APIリファレンス

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

概要

投稿

ユーザー

ダイレクトメッセージ

いいね

リスト

スペース

コミュニティ

コミュニティノート

トレンド

ニュース

メディア

X のアクティビティ

利用状況

ストリーム接続

コンプライアンス

Enterprise v2

いいねのストリーム

GNIP 2.0

Full-Archive Search クイックスタート

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

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

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

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

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

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

ページネーションガイド

Recent Search との主な違い

共通パラメーター

次のステップ

クエリを構築する

演算子リファレンス

ページネーションガイド

APIリファレンス