Working code samples for the X API v2 in Python, JavaScript, Ruby, Java, and R.
āāā python/ # 65 Python examples
āāā javascript/ # 59 JavaScript examples
āāā ruby/ # 58 Ruby examples
āāā java/ # 19 Java examples
āāā r/ # 5 R examples
āāā llms.txt # LLM-friendly documentation
āāā api-index.json # Machine-readable endpoint catalog
Sign up at the X Developer Portal.
For read-only operations (search, lookup):
export BEARER_TOKEN='your_bearer_token'
For user actions (post, like, repost, bookmark, etc.):
export CLIENT_ID='your_client_id' export CLIENT_SECRET='your_client_secret'
For OAuth 1.0a (legacy endpoints):
export CONSUMER_KEY='your_consumer_key' export CONSUMER_SECRET='your_consumer_secret'
# Python cd python && pip install -r requirements.txt python posts/search_recent.py # JavaScript cd javascript node posts/search_recent.js # Ruby cd ruby && bundle install ruby posts/search_recent.rb # Java cd java javac -cp ".:lib/*" posts/RecentSearchDemo.java java -cp ".:lib/*" RecentSearchDemo
| Category | Python | JavaScript | Ruby | Java | R |
|---|---|---|---|---|---|
| Posts (search, create, delete, likes, reposts) | ā | ā | ā | ā | ā |
| Users (lookup, followers, following, blocks, mutes) | ā | ā | ā | ā | ā |
| Timelines (user, mentions, home) | ā | ā | ā | ā | |
| Streams (filtered, sampled) | ā | ā | ā | ā | |
| Lists (lookup, manage, members, follow) | ā | ā | ā | ||
| Spaces (lookup, search) | ā | ā | ā | ā | |
| Bookmarks | ā | ā | ā | ||
| Direct Messages | ā | ||||
| Media Upload | ā | ||||
| Compliance | ā | ā | |||
| Usage | ā | ā | ā |
| Type | Use Case | Env Vars |
|---|---|---|
| Bearer Token | Read-only (search, lookup) | BEARER_TOKEN |
| OAuth 2.0 PKCE | User actions (post, like, repost, bookmark, mute, etc.) | CLIENT_ID, CLIENT_SECRET |
| OAuth 1.0a | Legacy endpoints (if applicable) | CONSUMER_KEY, CONSUMER_SECRET |
llms.txt- Context file for AI assistantsapi-index.json- Machine-readable endpoint catalog
Apache 2.0