X API v2 Sample Code

Working code samples for the X API v2 in Python, JavaScript, Ruby, Java, and R.

📁 Repository Structure

├── python/           # 108 Python examples
├── javascript/       # 70 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

🚀 Quick Start

1. Get API Credentials

Sign up at the X Developer Portal.

2. Set Environment Variables

export BEARER_TOKEN='your_bearer_token'
export CONSUMER_KEY='your_consumer_key'
export CONSUMER_SECRET='your_consumer_secret'

3. Run an Example

# Python
cd python && pip install -r requirements.txt
python posts/recent_search.py

# JavaScript  
cd javascript && npm install
node posts/recent_search.js

# Ruby
cd ruby && bundle install
ruby posts/recent_search.rb

📚 Examples by Category

Category	Python	JavaScript	Ruby	Java	R
Posts (search, create, delete, likes, retweets)	✅	✅	✅	✅	✅
Users (lookup, followers, blocks, mutes)	✅	✅	✅	✅	✅
Timelines (user, mentions, home)	✅	✅	✅	✅
Streams (filtered, sampled)	✅	✅	✅	✅
Lists (lookup, manage, members)	✅	✅	✅
Spaces (lookup, search)	✅	✅	✅	✅
Bookmarks	✅	✅	✅
Direct Messages	✅
Media Upload	✅
Compliance	✅	✅		✅
Usage	✅	✅		✅

🔐 Authentication

Type	Use Case	Env Vars
Bearer Token	Read-only (search, lookup)	BEARER_TOKEN
OAuth 1.0a	User actions (post, like)	CONSUMER_KEY, CONSUMER_SECRET
OAuth 2.0 PKCE	Bookmarks, newer endpoints	OAuth flow

🤖 For LLMs

• llms.txt - Context file for AI assistants
• api-index.json - Machine-readable endpoint catalog

🔗 Resources

• X API Documentation
• Developer Portal

📄 License

Apache 2.0