最初のリクエストを送信する

このガイドでは、最初の 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"
  }
}

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

Bearer Token を取得する

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

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

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

エンドポイント	機能
User lookup	ユーザー名または ID でユーザープロフィールを取得
Post lookup	ID で投稿を取得
Recent search	過去 7 日間の投稿を検索

リクエストを送信する

cURL、Postman、またはお好みの HTTP クライアントを使用します:

# ユーザー名でユーザーを検索
curl "https://api.x.com/2/users/by/username/xdevelopers" \
  -H "Authorization: Bearer $BEARER_TOKEN"

レスポンスを解析する

レスポンスは 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 "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
JavaScript
公式 SDK

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

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

テスト用ツール

Postman

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

サンプルコード

複数の言語での例。

API リファレンス

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

トラブルシューティング

401 Unauthorized

Bearer Token が正しいか確認してください
トークンが再生成されていないことを確認してください
Authorization ヘッダーの形式を確認: Bearer YOUR_TOKEN

403 Forbidden

アプリがこのエンドポイントへのアクセス権を持っていない可能性があります
一部のエンドポイントはユーザーコンテキスト認証 (OAuth 1.0a または 2.0) が必要です
Developer Console でアプリの権限を確認してください

429 Too Many Requests

レート制限に達しました
再試行のタイミングについては x-rate-limit-reset ヘッダーを確認してください
コードに指数バックオフを実装してください

完全なエラーリファレンス →

次のステップ

認証を学ぶ

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

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

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

SDK を使う

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

何かを作る

作るもののアイデア。

Getting Started

Products

Fundamentals

Partners & Customers

Resources

最初のリクエストを送信する

cURL でクイックスタート

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

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

その他の例

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

テスト用ツール

Postman

サンプルコード

API リファレンス

トラブルシューティング

次のステップ

認証を学ぶ

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

SDK を使う

何かを作る

​cURL でクイックスタート

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

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

​その他の例

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

​テスト用ツール

Postman

サンプルコード

API リファレンス

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

​次のステップ

認証を学ぶ

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

SDK を使う

何かを作る

cURL でクイックスタート

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

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

その他の例

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

テスト用ツール

トラブルシューティング

次のステップ