# OAuth 2.0 App-Only
curl -X GET "https://api.x.com/2/users/by/username/elonmusk" \
  -H "Authorization: Bearer AAAA...your_bearer_token"

curl -X GET "https://api.sorsa.io/v3/info?username=elonmusk" \
  -H "ApiKey: your_api_key"

{
  "data": {
    "id": "44196397",
    "name": "Elon Musk",
    "username": "elonmusk",
    "public_metrics": {
      "followers_count": 100000000,
      "following_count": 500,
      "tweet_count": 30000,
      "listed_count": 12000
    },
    "verified": false,
    "profile_image_url": "https://pbs.twimg.com/..."
  }
}

{
  "id": "44196397",
  "display_name": "Elon Musk",
  "username": "elonmusk",
  "description": "...",
  "location": "...",
  "followers_count": 100000000,
  "followings_count": 500,
  "tweets_count": 30000,
  "favourites_count": 50000,
  "media_count": 1200,
  "verified": false,
  "protected": false,
  "can_dm": true,
  "profile_image_url": "https://pbs.twimg.com/...",
  "profile_background_image_url": "...",
  "bio_urls": ["https://example.com"],
  "pinned_tweet_ids": ["17823..."],
  "possibly_sensitive": false,
  "created_at": "2009-06-02T00:00:00Z"
}

{
  "data": {
    "id": "1234567890",
    "text": "Hello world",
    "created_at": "2024-01-15T12:00:00.000Z",
    "public_metrics": {
      "retweet_count": 100,
      "reply_count": 50,
      "like_count": 500,
      "quote_count": 25,
      "bookmark_count": 10,
      "impression_count": 50000
    },
    "author_id": "44196397",
    "conversation_id": "1234567890",
    "in_reply_to_user_id": "...",
    "lang": "en"
  },
  "includes": {
    "users": [
      { "id": "44196397", "name": "Elon Musk", "username": "elonmusk" }
    ]
  }
}

{
  "id": "1234567890",
  "full_text": "Hello world",
  "created_at": "2024-01-15T12:00:00.000Z",
  "likes_count": 500,
  "retweet_count": 100,
  "reply_count": 50,
  "quote_count": 25,
  "bookmark_count": 10,
  "view_count": 50000,
  "lang": "en",
  "is_reply": false,
  "is_quote_status": false,
  "is_replies_limited": false,
  "conversation_id_str": "1234567890",
  "in_reply_to_tweet_id": null,
  "in_reply_to_username": null,
  "user": {
    "id": "44196397",
    "display_name": "Elon Musk",
    "username": "elonmusk",
    "followers_count": 100000000
  },
  "entities": [],
  "quoted_status": null,
  "retweeted_status": null
}

GET /2/users/44196397/followers?max_results=100&pagination_token=abc123

{
  "data": [...],
  "meta": {
    "next_token": "abc123",
    "result_count": 100
  }
}

GET /followers?username=elonmusk&cursor=abc123

{
  "query": "from:elonmusk",
  "next_cursor": "abc123"
}

{
  "tweets": [...],
  "next_cursor": "xyz789"
}

import requests

BEARER_TOKEN = "AAAA...your_bearer_token"

url = "https://api.x.com/2/users/by/username/elonmusk"
params = {
    "user.fields": "description,public_metrics,profile_image_url,verified,created_at"
}
headers = {"Authorization": f"Bearer {BEARER_TOKEN}"}

response = requests.get(url, headers=headers, params=params)
data = response.json()

user = data["data"]
followers = user["public_metrics"]["followers_count"]
name = user["name"]

import requests

API_KEY = "your_api_key"

url = "https://api.sorsa.io/v3/info"
params = {"username": "elonmusk"}
headers = {"ApiKey": API_KEY}

response = requests.get(url, headers=headers, params=params)
user = response.json()

followers = user["followers_count"]
name = user["display_name"]

url = "https://api.x.com/2/tweets/search/recent"
params = {
    "query": "from:elonmusk since:2024-01-01",
    "tweet.fields": "created_at,public_metrics,lang",
    "expansions": "author_id",
    "user.fields": "username,name",
    "max_results": 10
}
headers = {"Authorization": f"Bearer {BEARER_TOKEN}"}

response = requests.get(url, headers=headers, params=params)
data = response.json()

tweets = data["data"]
users = {u["id"]: u for u in data.get("includes", {}).get("users", [])}
next_token = data.get("meta", {}).get("next_token")

url = "https://api.sorsa.io/v3/search-tweets"
payload = {
    "query": "from:elonmusk since:2024-01-01"
}
headers = {"ApiKey": API_KEY}

response = requests.post(url, headers=headers, json=payload)
data = response.json()

tweets = data["tweets"]        # each tweet already includes user data
next_cursor = data.get("next_cursor")

const tweetId = "1234567890";

const response = await fetch(
  `https://api.x.com/2/tweets/${tweetId}?tweet.fields=public_metrics,created_at&expansions=author_id&user.fields=username,name`,
  { headers: { Authorization: `Bearer ${BEARER_TOKEN}` } }
);
const { data, includes } = await response.json();

const likes = data.public_metrics.like_count;
const author = includes.users[0].name;

const response = await fetch("https://api.sorsa.io/v3/tweet-info", {
  method: "POST",
  headers: {
    "ApiKey": API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    tweet_link: "https://x.com/elonmusk/status/1234567890",
  }),
});
const tweet = await response.json();

const likes = tweet.likes_count;
const author = tweet.user.display_name;

let paginationToken = null;
let allFollowers = [];

do {
  const params = new URLSearchParams({ max_results: "100" });
  if (paginationToken) params.set("pagination_token", paginationToken);

  const res = await fetch(
    `https://api.x.com/2/users/44196397/followers?${params}`,
    { headers: { Authorization: `Bearer ${BEARER_TOKEN}` } }
  );
  const json = await res.json();

  allFollowers.push(...(json.data || []));
  paginationToken = json.meta?.next_token || null;
} while (paginationToken);

let cursor = null;
let allFollowers = [];

do {
  const params = new URLSearchParams({ user_id: "44196397" });
  if (cursor) params.set("cursor", cursor);

  const res = await fetch(
    `https://api.sorsa.io/v3/followers?${params}`,
    { headers: { ApiKey: API_KEY } }
  );
  const json = await res.json();

  allFollowers.push(...(json.users || []));
  cursor = json.next_cursor || null;
} while (cursor);

{
  "errors": [
    {
      "message": "Not Found",
      "type": "https://api.x.com/2/problems/resource-not-found",
      "title": "Not Found Error",
      "detail": "Could not find tweet with id: [123].",
      "status": 404
    }
  ]
}

{
  "message": "Error description"
}