最初のリクエストを実行する

数分で X API の利用を開始できます

このガイドでは、最初の X API リクエストの実行手順を順を追って説明します。始める前に、App の認証情報を持つ開発者アカウントが必要です。

---

​

cURL を使ったクイックスタート

API をテストする最も手軽な方法は cURL を使うことです。ユーザーを取得してみましょう。

curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

$BEARER_TOKEN を実際のベアラートークンに置き換えてください。次のようなレスポンスが返ってきます:

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "xdevelopers"
  }
}

---

​

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

1. ベアラートークンを取得する

   開発者コンソールで対象の App を開き、ベアラートークンをコピーします。

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

   まずは次のような初心者向けのエンドポイントから始めましょう。

   Endpoint	機能
   User lookup	ユーザー名または ID からユーザープロフィールを取得
   Post lookup	ID でポストを取得
   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 パラメータを使用します。

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": "X Developer Platformの声",
    "public_metrics": {
      "followers_count": 570842,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

フィールドの詳細はこちら →

---

​

その他の例

ポストを取得

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

最近の投稿を検索

curl "https://api.x.com/2/tweets/search/recent?query=from:xdevelopers&tweet.fields=created_at" \
  -H "Authorization: Bearer $BEARER_TOKEN"

ユーザーの投稿を取得

curl "https://api.x.com/2/users/2244994945/tweets?max_results=5" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

cURL の代わりにコードを使用する

Python

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())

JavaScript

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

fetch(url, {
  headers: { Authorization: `Bearer ${bearerToken}` }
})
  .then(res => res.json())
  .then(data => console.log(data));

公式 SDK

本番環境での利用には、公式 SDK の使用を推奨します。

• Python SDK
• TypeScript SDK

これらは認証、ページネーション、レート制限を自動的に処理します。

---

​

テスト用ツール

Postman

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

サンプルコード

複数言語でのサンプルコード。

APIリファレンス

各エンドポイントの詳細なドキュメント。

---

​

トラブルシューティング

401 Unauthorized

• ベアラートークンが正しいことを確認してください
• トークンが再発行されていないことを確認してください
• Authorization ヘッダーの形式を確認してください: Bearer YOUR_TOKEN

403 Forbidden

• App がこのエンドポイントにアクセスできない可能性があります
• 一部のエンドポイントでは、ユーザーコンテキストでの認証 (OAuth 1.0a または 2.0) が必要です
• 開発者コンソールで App の権限を確認してください

429 Too Many Requests

• レート制限に達しています
• 再試行可能な時刻については、x-rate-limit-reset ヘッダーを確認してください
• コード内で指数バックオフを実装してください

エラーの詳細なリファレンス →

---

​

次のステップ

認証について学ぶ

ユーザーコンテキストのリクエストにおける OAuth を理解しましょう。

エンドポイントを探る

どのようなものを構築できるかを確認しましょう。

SDK を使う

公式ライブラリで開発を高速化しましょう。

何かを作ってみる

作成できるもののアイデアを見つけましょう。