Documentation Index
Fetch the complete documentation index at: https://generaltranslation.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
recent search endpoint では直近 7 日間に投稿された投稿のみを取得できますが、user Post timeline エンドポイントと user mention timeline エンドポイントを使用すると、認可されたユーザー (user ID を使用) に対して、過去 7 日間より前の投稿およびメンションも取得できます。開発者はこれらのエンドポイントを使って、ユーザーのタイムラインやメンションに含まれるトピック、エンティティ、感情 (センチメント) を調査できます。このチュートリアルでは、user Tweet timeline エンドポイントと user mention timeline エンドポイントを使って、ユーザーの投稿とメンションを探索する方法を説明します。
まだ開発者アカウントをお持ちでない場合は、こちらから申請してください。
開発者コンソール で「Create a new App」をクリックします。
名前を付け、適切なユースケースを選択し、Project の説明を入力します。次に、新しい App を作成するか、既存の App を接続するかを選べます (App は、X API に HTTP リクエストを送信するために必要な API キーを格納するコンテナです) 。
「Create a new App instead」をクリックし、新しい App を作成するために App に名前を付けます。
「Complete」をクリックすると、X API v2 の新しいエンドポイントに接続するために使用できる API キーとベアラートークンが取得できます。
API key、API secret key、ベアラートークンの横にある (+) をクリックし、これらの値をローカルマシン上の安全な場所にコピーします。次のステップで API 呼び出しを行う際に必要になります。
注: 上のスクリーンショット内のキーは非表示になっていますが、自身の開発者コンソールでは API key、API secret key、ベアラートークンの実際の値を確認できます。
ユーザーTweetタイムラインエンドポイントとユーザーメンションタイムラインエンドポイントでは、ユーザーIDを指定して投稿を取得できます。ユーザー名からユーザーIDを取得するには、新しい ユーザー参照エンドポイント v2 を使用します。USER_NAME を任意のユーザー名に、XXXX を先ほど取得した自身のベアラートークンにそれぞれ置き換えてください。
curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
{
"data": {
"id": "2244994945",
"name": "Developers",
"username": "XDevelopers"
}
}
ユーザーのツイートタイムラインエンドポイントおよびユーザーメンションタイムラインエンドポイントへの接続
USER_ID を任意のユーザーの id に、XXXX を上で取得したご自身のベアラートークンに置き換えてください) 。
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
{
"id": "1334200897081987072",
"text": "👀 If you are new to the X API v2, check out this step-by-step guide to making your first request https://t.co/4rZqThpSbp"
}
context_annotations オブジェクトを含めて返すよう指定します:
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
{
"domain": {
"id": "47",
"name": "Brand",
"description": "ブランドと企業"
},
"entity": {
"id": "783214",
"name": "X"
}
}
tweet.media フィールドで preview_image_url をリクエストし、attachments.media_keys を expansions に指定します。
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
{
"includes": {
"media": [
{
"media_key": "16_1334657439640121344",
"preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
"type": "animated_gif"
}
]
}
}
