X API

X API

Programmatic interaction with X (Twitter) for posting, reading, searching, and analytics.

When to Activate

• User wants to post tweets or threads programmatically
• Reading timeline, mentions, or user data from X
• Searching X for content, trends, or conversations
• Building X integrations or bots
• Analytics and engagement tracking
• User says "post to X", "tweet", "X API", or "Twitter API"

Authentication

OAuth 2.0 Bearer Token (App-Only)

Best for: read-heavy operations, search, public data.

# Environment setup
export X_BEARER_TOKEN="your-bearer-token"

import os
import requests

bearer = os.environ["X_BEARER_TOKEN"]
headers = {"Authorization": f"Bearer {bearer}"}

# Search recent tweets
resp = requests.get(
    "https://api.x.com/2/tweets/search/recent",
    headers=headers,
    params={"query": "claude code", "max_results": 10}
)
tweets = resp.json()