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

​
Posts ルックアップエンドポイントの始め方

このクイックスタートガイドでは、Postman を使用して、指定した一連の fields を含めた最初のリクエストを Posts ルックアップエンドポイントに送信する方法を説明します。 各種言語のサンプルコードをご覧になる場合は、GitHub の X API v2 sample code リポジトリをご参照ください。

​
前提条件

このガイドを完了するには、リクエストを認証するための keys and tokens が必要です。以下の手順に従って keys and tokens を生成できます。
  • 開発者アカウントに登録し、承認を受ける。
  • 開発者ポータルで Project を作成し、関連付けられた アプリ を作成する。
  • アプリの「Keys and tokens」ページに移動して、必要な認証情報を生成する。すべての認証情報は安全な場所に保存してください。

​
GET /tweets リクエストを構築する手順

​
ステップ1：ツールまたはライブラリから始める

このエンドポイントにリクエストを送る方法はいくつかあり、さまざまなツール、コード例、ライブラリが利用できますが、ここでは手順を簡略化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、以下のボタンをクリックしてください。
Postman に X API v2 コレクションを読み込んだら、「Post Lookup > Multiple Posts」リクエストに移動します。

​
ステップ2：リクエストを認証する

X API に正しくリクエストするには、アクセス権限があることを確認する必要があります。リクエストの認証には次の方法を使用できます。 簡単のため、このリクエストでは OAuth 2.0 App-Only を使用しますが、非公開のmetricsや Post を取得したい場合は、他のいずれかの認証方法を使用する必要があります。 OAuth 2.0 App-Only を使用するには、Postman の右上にある環境で “X API v2” を選択し、環境ドロップダウン横の目のアイコンをクリックして表示される「initial value」と「current value」の fields に、キーとトークン（特に App Access Token［App-only Bearer Token とも呼ばれます］）を追加してください。 正しく設定できていれば、これらの変数はリクエストの authorization タブに自動的に反映されます。

​
ステップ3: 取得したいPostを特定して指定する

リクエスト内で、受け取りたいPostまたはPostのセットを指定する必要があります。X.comでPostを開き、URLを確認するとPostのIDを見つけることができます。たとえば、次のURLのPost IDは1228393702244134912です。 https://x.com/TwitterDev/status/1228393702244134912 Postmanで「Params」タブに移動し、このID、またはカンマ区切りの複数のPost IDを、idsパラメータの「Value」列に入力します。
KeyValue
ids1228393702244134912,1227640996038684673,1199786642791452673

​
ステップ4：取得する fields を特定して指定する

ステップ3の後に「Send」ボタンをクリックすると、レスポンスにはデフォルトの Post オブジェクトの fields が返されます：id、text、edit_history_tweet_ids。 この演習では、異なるオブジェクトから追加で3つの異なる fields セットをリクエストします。
  • 主要な Post オブジェクトに対する追加の tweet.created_at field
  • 返される Posts の作成者に対応するユーザーオブジェクトのデフォルト fields：id、name、username
  • 関連するユーザーオブジェクトに対する追加の user.created_at field
Postman で「Params」タブに移動し、「Query Params」テーブルに次の key:value ペアを追加します。
KeyValueReturned fields
tweet.fieldscreated_attweets.created_at
expansionsauthor_idincludes.users.id, includes.users.name, includes.users.username
user.fieldscreated_atincludes.users.created_at
「Send」ボタンの横に次の URL が表示されるはずです。 
https://api.x.com/2/tweets?ids=1228393702244134912,1227640996038684673,1199786642791452673&tweet.fields=created_at&expansions=author_id&user.fields=created_at

​
ステップ5：リクエストを送信してレスポンスを確認する

準備が整ったら「Send」ボタンをクリックすると、次のレスポンスが表示されます。 
{
    "data": [
        {
            "edit_history_tweet_ids": [
                "1228393702244134912"
            ],
            "text": "開発者はバレンタインカードに何と書いたでしょう?\n  \nwhile(true) {\n    I = Love(You);  \n}",
            "id": "1228393702244134912",
            "created_at": "2020-02-14T19:00:55.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1227640996038684673"
            ],
            "text": "医者: ネットで調べても医者にはなれない\n\n開発者: https://t.co/mrju5ypPkb",
            "id": "1227640996038684673",
            "created_at": "2020-02-12T17:09:56.000Z",
            "author_id": "2244994945"
        },
        {
            "edit_history_tweet_ids": [
                "1199786642791452673"
            ],
            "text": "C#",
            "id": "1199786642791452673",
            "created_at": "2019-11-27T20:26:41.000Z",
            "author_id": "2244994945"
        }
    ],
    "includes": {
        "users": [
            {
                "name": "開発者",
                "created_at": "2013-12-14T04:35:55.000Z",
                "id": "2244994945",
                "username": "XDevelopers"
            }
        ]
    }
}