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

​
Posts ルックアップ endpoint のはじめに

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

​
前提条件

このガイドを完了するには、リクエストを認証するためのキーおよびトークンが必要です。以下の手順でキーおよびトークンを生成できます。
  • デベロッパーアカウントに登録し、承認を受けます。
  • developer portal でProjectを作成し、関連付けられた開発者用 Appを作成します。
  • 必要な認証情報を生成するために、App の「Keys and tokens」ページに移動します。すべての認証情報は安全な場所に保管してください。

​
GET /tweets リクエストを作成する手順

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

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

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

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

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

リクエスト内で、取得したいPostまたは複数のPostsを必ず指定してください。Post IDは、X.comで該当のPostを開き、URLを確認することで見つけられます。たとえば、次の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=作成日時&expansions=author_id&user.fields=作成日時

​
ステップ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"
            }
        ]
    }
}
⌘I