samples

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #typescript #llm #android #machine-learning #rust #deep-learning #windows #awesome-list #security #mcp

(★ 3,199)

Sample code for the X API v2 endpoints

File Explorer

Download Latest Version (.zip)

- - bug_report.md
  - config.yml
- - cla.yml
- - FullArchiveSearchDemo.java
  - FullArchiveTweetCountsDemo.java
  - QuoteTweetsDemo.java
  - RecentSearchDemo.java
  - RecentTweetCountsDemo.java
  - SearchRecent.java
  - TweetsDemo.java
- - SearchSpacesDemo.java
  - SpacesLookupDemo.java
- - FilteredStreamDemo.java
  - SampledStream.java
- - reverse-chron-home-timeline-java-sdk.java
  - UserMentionsDemo.java
  - UserTweetsDemo.java
- - UsageTweetsDemo.java
- - FollowersLookupDemo.java
  - FollowingLookupDemo.java
  - Lookup.java
  - UsersDemo.java
- README.md
- - create_jobs.js
  - download_results.js
  - get_jobs.js
  - get_jobs_by_id.js
  - upload_ids.js
- - add_member.js
  - create_list.js
  - delete_list.js
  - get_list_by_id.js
  - get_list_followers.js
  - get_list_members.js
  - get_list_posts.js
  - remove_member.js
  - update_list.js
- - create_post.js
  - delete_post.js
  - get_liking_users.js
  - get_post_counts_all.js
  - get_post_counts_recent.js
  - get_posts_by_ids.js
  - get_posts_by_ids_user_context.js
  - get_quoted_posts.js
  - get_reposted_by.js
  - search_all.js
  - search_recent.js
- - get_spaces_by_ids.js
  - search_spaces.js
- - stream_posts_filtered.js
  - stream_posts_sample.js
- - get_usage.js
- - get_users_by_usernames.js
  - get_users_by_usernames_user_context.js
  - get_users_me.js
- README.md
- - create_subscription.py
  - delete_subscription.py
  - list_subscriptions.py
  - stream_events.py
  - update_subscription.py
- - create_jobs.py
  - download_results.py
  - get_jobs.py
  - get_jobs_by_id.py
  - upload_ids.py
- - get_events_by_conversation.py
  - get_one_to_one_conversation_events.py
  - get_user_conversation_events.py
  - post_dm_to_conversation.py
  - post_group_conversation_dm.py
  - post_one_to_one_dm.py
- - add_member.py
  - create_list.py
  - delete_list.py
  - get_list_by_id.py
  - get_list_followers.py
  - get_list_members.py
  - get_list_posts.py
  - remove_member.py
  - update_list.py
- - media_upload_v2.py
  - upload.py
- - create_post.py
  - delete_post.py
  - get_liking_users.py
  - get_post_by_id.py
  - get_post_counts_all.py
  - get_post_counts_recent.py
  - get_posts_by_ids.py
  - get_quoted_posts.py
  - get_reposted_by.py
  - hide_reply.py
  - search_all.py
  - search_recent.py
- - get_spaces_by_ids.py
  - search_spaces.py
- - stream_posts_filtered.py
  - stream_posts_sample.py
- - get_usage.py
- - get_users_by_usernames.py
  - get_users_by_usernames_user_context.py
  - get_users_me.py
- - delete_webhook.py
  - list_webhooks.py
  - register_webhook.py
  - validate_webhook.py
  - webhook_server.py
- README.md
- requirements.txt
- - full-archive-search.r
  - full_archive_tweet_counts.r
  - recent-search.r
  - recent_tweet_counts.r
- - get_users_with_bearer_token.r
- - bookmarks_lookup.rb
- - add_member.rb
  - create_a_list.rb
  - delete_a_list.rb
  - follow_list.rb
  - list-followers-lookup.rb
  - list-lookup-by-id.rb
  - list-member-lookup.rb
  - List-Tweets.rb
  - lookup.rb
  - pin_list.rb
  - Pinned-List.rb
  - remove_member.rb
  - unfollow_list.rb
  - unpin_list.rb
  - update_a_list.rb
  - user-list-followed.rb
  - user-list-memberships.rb
  - user-owned-list-lookup.rb
- - create_tweet.rb
  - delete_tweet.rb
  - full-archive-search.rb
  - full_archive_tweet_counts.rb
  - get_tweets_with_bearer_token.rb
  - get_tweets_with_user_context.rb
  - like_a_tweet.rb
  - liked_tweets.rb
  - liking_users.rb
  - lookup.rb
  - quote_tweets.rb
  - recent_search.rb
  - recent_tweet_counts.rb
  - retweet_a_tweet.rb
  - retweeted_by.rb
  - search_recent.rb
  - undo_a_retweet.rb
  - unlike_a_tweet.rb
- - search_spaces.rb
  - spaces_lookup.rb
- - filtered_stream.rb
  - sampled_stream.rb
- - reverse-chron-home-timeline.rb
  - user-mentions.rb
  - user-tweets.rb
  - user_posts.rb
- - block_a_user.rb
  - followers-lookup.rb
  - followers.rb
  - following-lookup.rb
  - get_users_me_with_user_context.rb
  - get_users_with_bearer_token.rb
  - get_users_with_user_context.rb
  - lookup.rb
  - lookup_blocks.rb
  - lookup_mutes.rb
  - mute_a_user.rb
  - unblock_a_user.rb
  - unmute_a_user.rb
- Gemfile
- README.md
.gitignore
api-index.json
CODE_OF_CONDUCT.md
LICENSE
llms.txt
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# X API v2 Sample Code

[![X API v2](https://img.shields.io/endpoint?url=https%3A%2F%2Ftwbadges.glitch.me%2Fbadges%2Fv2)](https://developer.x.com/en/docs/twitter-api)

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

## 📁 Repository Structure

```
├── 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
```

## 🚀 Quick Start

### 1. Get API Credentials

### 2. Set Environment Variables

**For read-only operations (search, lookup):**
```bash
export BEARER_TOKEN='your_bearer_token'
```

**For user actions (post, like, repost, bookmark, etc.):**
```bash
export CLIENT_ID='your_client_id'
export CLIENT_SECRET='your_client_secret'
```

**For OAuth 1.0a (legacy endpoints):**
```bash
export CONSUMER_KEY='your_consumer_key'
export CONSUMER_SECRET='your_consumer_secret'
```

### 3. Run an Example

```bash
# 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
```

## 📚 Examples by Category

| 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 | ✅ | ✅ | | ✅ | |

## 🔐 Authentication

| 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` |

## 🤖 For LLMs

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

## 🔗 Resources

- [X API Documentation](https://developer.x.com/en/docs/twitter-api)
- [Developer Portal](https://developer.x.com/en/portal/dashboard)

## 📄 License

Apache 2.0

samples

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

samples

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README