ユーザーのPostおよびメンションのタイムラインエンドポイントのはじめ方
前提条件このガイドを完了するには、リクエストを認証するための一連の keys and tokens が必要です。以下の手順に従うことで、これらのキーとトークンを生成できます。 XDevelopers です。
https://x.com/XDevelopers
このユーザー名をユーザー ID に変換するには、ユーザー名を指定して users lookup endpoint を使用し、ペイロード内から数値のユーザー ID を確認します。@XDevelopers の場合、ユーザー ID は 2244994945 です。
Postman では、「Params」タブに移動し、id パラメータの「Value」列にこのユーザー ID を入力します。
ステップ4: 取得したい fields を特定して指定する
手順3の後に「Send」ボタンをクリックすると、レスポンスにはデフォルトの Post object の fields である id と text が返されます。
id と text 以外の追加の fields を受け取りたい場合は、リクエストで fields および/または expansions パラメータを指定してください。
この演習では、異なるオブジェクトから以下の3種類の追加の fields セットをリクエストします:
- プライマリのツイートオブジェクトに対する追加の tweet.created_at field
- 返される Posts の作成者に対応するユーザーオブジェクトのデフォルト fields（id、name、username）
- 関連するユーザーオブジェクトに対する追加の user.created_at field
Postman で「Params」タブに移動し、「Query Params」テーブルに次のキーと値のペアを追加します:
| | |
|---|
| Key | Value | Returned fields |
tweet.fields | created_at | tweets.created_at |
expansions | author_id | includes.users.id、includes.users.name、includes.users.username |
user.fields | created_at | includes.users.created_at |
| max_results | 5 | |
https://api.x.com/2/users/:id/tweets?tweet.fields=created_at&expansions=author_id&user.fields=created_at&max_results=5
ご注意ください:Postman では、URL フィールドのパスパラメータ :id は id パラメータフィールドに入力した値に自動的には更新されません。したがって、上記の URL には 2244994945 ではなく :id が含まれています。
"data": [
{
"author_id": "2244994945",
"created_at": "2020-09-03T17:31:39.000Z",
"id": "1301573587187331074",
"text": "本日より、開発者ポータルで v2 API の月間ツイート使用状況を確認できるようになりました。✨📊\n\nフィルター済みストリームと最近の検索で受信したツイート数を追跡します。詳しくはこちら: https://t.co/nfJHkFRQcZ https://t.co/vFXmoj3qaA"
},
{
"author_id": "2244994945",
"created_at": "2020-09-03T15:43:00.000Z",
"id": "1301546240887398401",
"text": "RT @snowman: X API を使い、Python、Flask、Postgres、Heroku でリアルタイムのゴルフリーダーボードを作りました。\n\n「leaderboard」をダイレクトメッセージで送って…"
},
{
"author_id": "2244994945",
"created_at": "2020-09-01T20:07:50.000Z",
"id": "1300888112948752389",
"text": "⛳ なぜゴルファーは替えのシャツを持ち歩くのでしょうか？ ホールインワンに備えるためです。\n\nさて注目していただけたところで、@snowman と @johnd が #TwitterAPI を使ってリアルタイムのゴルフリーダーボードを構築した方法を学んでください。📖\n\nhttps://t.co/rRKeKmaRrN"
},
{
"author_id": "2244994945",
"created_at": "2020-08-28T23:14:22.000Z",
"id": "1299485505478963200",
"text": "RT @jessicagarson: @ThePracticalDev に、Twitter API v2 の使い方に関する最初のチュートリアルを投稿しました！ ユーザーのツイートを探索する方法が学べます…"
},
{
"author_id": "2244994945",
"created_at": "2020-08-21T19:10:05.000Z",
"id": "1296887316556980230",
"text": "@PennMedCDH が Twitter のデータを使って COVID-19 の健康危機をどのように理解しているかをご覧ください。📊\n\nhttps://t.co/1tdA8uDWes"
}
],
"includes": {
"users": [
{
"created_at": "2013-12-14T04:35:55.000Z",
"id": "2244994945",
"name": "Twitter Dev",
"username": "TwitterDev"
}
]
},
"meta": {
"newest_id": "1301573587187331074",
"next_token": "t3buvdr5pujq9g7bggsnf3ep2ha28",
"oldest_id": "1296887316556980230",
"previous_token": "t3equkmcd2zffvags2nkj0nhlrn78",
"result_count": 5
}
}
- oldest_id
- newest_id
- results_count
- next_token
- previous_token
ステップ4では max_results の値を 5 に指定したため、各ページには最大で 5 件の結果のみが含まれます。追加のページの data にアクセスするには、直前の結果に含まれる next_token フィールドの値を取得し、その文字列を Postman の params ページで pagination_token パラメータの値として設定し、その他はそのままにします。
| |
|---|
| Key | Value |
pagination_token | t3buvdr5pujq9g7bggsnf3ep2ha28 |
