Skip to main content
このガイドでは、最初の X API リクエストを送信する手順を説明します。開始する前に、アプリ認証情報を含むデベロッパーアカウント が必要です。

​
cURL でクイックスタート

API をテストする最も簡単な方法は cURL です。ユーザーを検索してみましょう: 
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
$BEARER_TOKEN を実際の Bearer Token に置き換えてください。次のようなレスポンスが返されます: 
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

​
ステップバイステップガイド

1

Bearer Token を取得する

Developer Console でアプリに移動し、Bearer Token をコピーします。
2

エンドポイントを選択する

まずは初心者向けの次のエンドポイントから始めましょう:
エンドポイント機能
User lookupユーザー名または ID でユーザープロフィールを取得
Post lookupID で投稿を取得
Recent search過去 7 日間の投稿を検索
3

リクエストを送信する

cURL、Postman、またはお好みの HTTP クライアントを使用します:
# ユーザー名でユーザーを検索
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"
4

レスポンスを解析する

レスポンスは JSON 形式です。主要なデータは data フィールドに含まれます:
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

​
fields でより多くのデータをリクエストする

デフォルトでは、エンドポイントは最小限のフィールドのみを返します。fields パラメータを使用して追加データをリクエストできます: 
curl "https://api.x.com/2/users/by/username/xdevelopers?user.fields=created_at,description,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"
レスポンス: 
{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X Developer Platform",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}
fields の詳細はこちら →

​
その他の例

curl "https://api.x.com/2/tweets/1460323737035677698?tweet.fields=created_at,public_metrics" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
cURL の代わりにコードを使う

import requests

bearer_token = "YOUR_BEARER_TOKEN"
url = "https://api.x.com/2/users/by/username/xdevelopers"

headers = {"Authorization": f"Bearer {bearer_token}"}
response = requests.get(url, headers=headers)

print(response.json())

​
テスト用ツール

Postman

コレクションを使ったビジュアル API テスト。

サンプルコード

複数の言語での例。

API リファレンス

エンドポイントの完全なドキュメント。

​
トラブルシューティング

  • Bearer Token が正しいか確認してください
  • トークンが再生成されていないことを確認してください
  • Authorization ヘッダーの形式を確認: Bearer YOUR_TOKEN
  • アプリがこのエンドポイントへのアクセス権を持っていない可能性があります
  • 一部のエンドポイントはユーザーコンテキスト認証 (OAuth 1.0a または 2.0) が必要です
  • Developer Console でアプリの権限を確認してください
  • レート制限に達しました
  • 再試行のタイミングについては x-rate-limit-reset ヘッダーを確認してください
  • コードに指数バックオフを実装してください
完全なエラーリファレンス →

​
次のステップ

認証を学ぶ

ユーザーコンテキストリクエストのための OAuth を理解しましょう。

エンドポイントを探索する

何が構築できるか発見しましょう。

SDK を使う

公式ライブラリで開発を加速。

何かを作る

作るもののアイデア。