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

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

このクイックスタートガイドでは、Postman を使って Retweets ルックアップエンドポイントに最初のリクエストを送る手順を説明します。各種言語のサンプルコードは、GitHub の X API v2 sample code リポジトリをご覧ください。

​
前提条件

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

​
リツイート照会リクエストを作成する手順

ステップ1：ツールまたはライブラリから始めましょう このエンドポイントにリクエストを送る方法はいくつもあり、さまざまなツール、コード例、ライブラリを利用できますが、ここでは手順を簡略化するために Postman を使用します。 X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください。
X API v2コレクションをPostmanに読み込んだら、「Retweets」フォルダーに移動して「Retweeted by」を選択します。 手順 2: リクエストを認証する X API へリクエストを正しく送信するには、適切な権限を持っていることを確認する必要があります。このエンドポイントでは、OAuth 2.0 App-Only、OAuth 2.0 認可コード（PKCE 対応）、または OAuth 1.0a ユーザーコンテキスト のいずれかの認証方式を使用してリクエストを認証する必要があります。 簡略化のため、このリクエストではOAuth 2.0 App-Onlyを使用しますが、非公開のメトリクスやリツイートをリクエストする場合は、他の認証方法のいずれかを使用する必要があります。 OAuth 2.0 の App-Only を利用するには、キーとトークン、特に App Access Token（App-only Bearer Token とも呼ばれます）を Postman に追加する必要があります。Postman の右上で “X API v2” という名前の環境を選択し、環境ドロップダウン横の目のアイコンをクリックして、“initial value” と “current value” の fields にキーとトークンを追加してください。 正しく設定されている場合、これらの変数はリクエストの認証タブに自動的に読み込まれます。 ステップ3: ポストを指定する このエンドポイントでは、リポストしたユーザーを取得したいPostのIDを指定する必要があります。PostのIDは、X上でそのPostに移動し、URLの末尾にある数値コードを確認することで取得できます。例えば、次のURLのPost IDは1354143047324299264です。 https://x.com/TwitterDev/status/1354143047324299264 Postmanで「Params」タブに移動し、このユーザー名をidパス変数の「Value」列（セクションの下部）に入力します。ユーザー名の前後にスペースを含めないよう注意してください。
キー値
idリポストしたユーザーを取得する対象のPostのid
ステップ4: 取得するフィールドを特定して指定する ステップ3の後に「送信」ボタンをクリックすると、レスポンスにデフォルトのuserオブジェクトフィールドが返されます：id、name、username。 id、name、username以外の追加フィールドを取得する場合は、fieldsパラメータやexpansionsパラメータを使用してリクエストでそれらのフィールドを指定する必要があります。 この演習では、異なるオブジェクトから3つの追加fieldsセットをリクエストします:
  1. プライマリユーザーオブジェクトに追加された user.created_at フィールド。
  2. 返されるユーザーについて、関連付けられた固定済みPostオブジェクトのデフォルトfieldsは、id と text です。
  3. 関連するPostオブジェクト内の追加の tweet.created_at フィールド。
Postman で「Params」タブを開き、「Query Params」テーブルに次のキーと値のペアを追加します。
重要値返されるfields
user.fields作成_でuser.created_で
expansionsピン留め_Tweet_idtweet.id, tweet.text
tweet.fields作成_でTweet.created_で
「送信」ボタンの横に、次のURLが表示されているはずです。 https://api.x.com/2/tweets/1354143047324299264/retweeted_by?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at ステップ5：リクエストを送信し、レスポンスを確認する 準備が整ったら「Send」ボタンをクリックすると、以下のサンプルと同様のレスポンスが返ってきます。 
{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Twitter Support"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    },
    {
      "pinned_tweet_id": "1293595870563381249",
      "created_at": "2007-05-23T06:01:13.000Z",
      "id": "6253282",
      "username": "XAPI",
      "name": "X API"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "now, everyone with 600 or more followers can host a Space.\n\nbased on what we've learned, these accounts are likely to have a good experience hosting because of their existing audience. before bringing the ability to create a Space to everyone, we’re focused on a few things. 🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2: Early Access released\n\nToday we announced Early Access to the first endpoints of the new Twitter API!\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}