more cahnges

Author: santiagomed

README.md

@@ -2,15 +2,16 @@
 
 [![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 (formerly Twitter) API v2** in Python, JavaScript, Ruby, and Java.
+Working code samples for the **X API v2** in Python, JavaScript, Ruby, Java, and R.
 
 ## 📁 Repository Structure
 
 ```
-├── python/           # Python examples (most complete)
-├── javascript/       # JavaScript (Node.js) examples
-├── ruby/             # Ruby examples
-├── java/             # Java examples
+├── 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
 ```
@@ -19,110 +20,66 @@ Working code samples for the **X (formerly Twitter) API v2** in Python, JavaScri
 
 ### 1. Get API Credentials
 
-Sign up at the [X Developer Portal](https://developer.x.com/en/portal/dashboard) and create a project/app.
+Sign up at the [X Developer Portal](https://developer.x.com/en/portal/dashboard).
 
 ### 2. Set Environment Variables
 
 ```bash
-# For app-only authentication (read-only endpoints)
 export BEARER_TOKEN='your_bearer_token'
-
-# For user context authentication (actions on behalf of users)
 export CONSUMER_KEY='your_consumer_key'
 export CONSUMER_SECRET='your_consumer_secret'
 ```
 
-### 3. Choose Your Language
-
-| Language | Setup | Run Example |
-|----------|-------|-------------|
-| **Python** | `pip install -r python/requirements.txt` | `python python/posts/search_recent.py` |
-| **JavaScript** | `cd javascript && npm install` | `node javascript/posts/search_recent.js` |
-| **Ruby** | `gem install typhoeus` | `ruby ruby/posts/search_recent.rb` |
-| **Java** | Add dependencies (see java/README.md) | `javac && java SearchRecent` |
-
-## 📚 Available Examples
-
-### Posts (formerly Tweets)
-
-| Operation | Python | JavaScript | Ruby | Java |
-|-----------|--------|------------|------|------|
-| Create Post | ✅ | ✅ | | |
-| Delete Post | ✅ | ✅ | | |
-| Lookup Posts | ✅ | ✅ | ✅ | |
-| Search Recent | ✅ | ✅ | ✅ | ✅ |
-| Search Full Archive | ✅ | | | |
-| Post Counts | ✅ | | | |
-| Quote Posts | ✅ | | | |
-| Repost | ✅ | | | |
-| Like/Unlike | ✅ | | | |
-
-### Users
-
-| Operation | Python | JavaScript | Ruby | Java |
-|-----------|--------|------------|------|------|
-| Lookup Users | ✅ | ✅ | ✅ | ✅ |
-| Get Me | ✅ | | | |
-| Followers | ✅ | ✅ | ✅ | |
-| Following | ✅ | | | |
-| Block/Unblock | ✅ | | | |
-| Mute/Unmute | ✅ | | | |
-
-### Timelines
-
-| Operation | Python | JavaScript | Ruby |
-|-----------|--------|------------|------|
-| User Posts | ✅ | ✅ | ✅ |
-| User Mentions | ✅ | | |
-| Home Timeline | ✅ | | |
-
-### Streams
-
-| Operation | Python | JavaScript |
-|-----------|--------|------------|
-| Filtered Stream | ✅ | ✅ |
-| Sampled Stream | ✅ | |
-
-### Other
-
-| Category | Python | JavaScript | Ruby |
-|----------|--------|------------|------|
-| Bookmarks | ✅ | | |
-| Spaces | ✅ | ✅ | |
-| Lists | ✅ | ✅ | ✅ |
-| Direct Messages | ✅ | | |
-| Media Upload | ✅ | | |
-| Compliance | ✅ | | |
-| Usage Stats | ✅ | | |
-
-## 🔐 Authentication Types
-
-| Type | Use Case | Required Env Vars |
-|------|----------|-------------------|
-| **Bearer Token** | Read-only endpoints (search, lookup) | `BEARER_TOKEN` |
-| **OAuth 1.0a** | User actions (post, like, follow) | `CONSUMER_KEY`, `CONSUMER_SECRET` |
-| **OAuth 2.0 PKCE** | Newer endpoints (bookmarks) | OAuth flow required |
+### 3. Run an Example
 
-## 🔗 Resources
+```bash
+# Python
+cd python && pip install -r requirements.txt
+python posts/recent_search.py
 
-- [X API Documentation](https://developer.x.com/en/docs/twitter-api)
-- [Developer Portal](https://developer.x.com/en/portal/dashboard)
-- [API Reference Index](https://developer.x.com/en/docs/api-reference-index)
-- [Postman Collection](https://t.co/twitter-api-postman)
+# 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
 
-This repository includes:
-- **`llms.txt`** - Comprehensive context file for AI assistants
+- **`llms.txt`** - Context file for AI assistants
 - **`api-index.json`** - Machine-readable endpoint catalog
 
-## 🤝 Contributing
+## 🔗 Resources
 
-We welcome contributions! Please:
-1. Follow existing code patterns
-2. Include proper documentation headers
-3. Test your examples before submitting
+- [X API Documentation](https://developer.x.com/en/docs/twitter-api)
+- [Developer Portal](https://developer.x.com/en/portal/dashboard)
 
 ## 📄 License
 
-Apache 2.0 - See [LICENSE](LICENSE)
+Apache 2.0

java/posts/FullArchiveSearchDemo.java

@@ -0,0 +1,65 @@
+import java.io.IOException;
+import java.net.URISyntaxException;
+import java.util.ArrayList;
+
+import org.apache.http.HttpEntity;
+import org.apache.http.HttpResponse;
+import org.apache.http.NameValuePair;
+import org.apache.http.client.HttpClient;
+import org.apache.http.client.config.CookieSpecs;
+import org.apache.http.client.config.RequestConfig;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.utils.URIBuilder;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.util.EntityUtils;
+
+/*
+ * Sample code to demonstrate the use of the Full archive search endpoint
+ * */
+public class FullArchiveSearchDemo {
+
+  // To set your enviornment variables in your terminal run the following line:
+  // export 'BEARER_TOKEN'='<your_bearer_token>'
+
+  public static void main(String args[]) throws IOException, URISyntaxException {
+    String bearerToken = System.getenv("BEARER_TOKEN");
+    if (null != bearerToken) {
+      //Replace the search term with a term of your choice
+      String response = search("from:TwitterDev OR from:SnowBotDev OR from:DailyNASA", bearerToken);
+      System.out.println(response);
+    } else {
+      System.out.println("There was a problem getting your bearer token. Please make sure you set the BEARER_TOKEN environment variable");
+    }
+  }
+
+  /*
+   * This method calls the full-archive search endpoint with a the search term passed to it as a query parameter
+   * */
+  private static String search(String searchString, String bearerToken) throws IOException, URISyntaxException {
+    String searchResponse = null;
+
+    HttpClient httpClient = HttpClients.custom()
+        .setDefaultRequestConfig(RequestConfig.custom()
+            .setCookieSpec(CookieSpecs.STANDARD).build())
+        .build();
+
+    URIBuilder uriBuilder = new URIBuilder("https://api.x.com/2/tweets/search/all");
+    ArrayList<NameValuePair> queryParameters;
+    queryParameters = new ArrayList<>();
+    queryParameters.add(new BasicNameValuePair("query", searchString));
+    uriBuilder.addParameters(queryParameters);
+
+    HttpGet httpGet = new HttpGet(uriBuilder.build());
+    httpGet.setHeader("Authorization", String.format("Bearer %s", bearerToken));
+    httpGet.setHeader("Content-Type", "application/json");
+
+    HttpResponse response = httpClient.execute(httpGet);
+    HttpEntity entity = response.getEntity();
+    if (null != entity) {
+      searchResponse = EntityUtils.toString(entity, "UTF-8");
+    }
+    return searchResponse;
+  }
+
+}

java/posts/FullArchiveTweetCountsDemo.java

@@ -0,0 +1,67 @@
+import java.io.IOException;
+import java.net.URISyntaxException;
+import java.util.ArrayList;
+
+import org.apache.http.HttpEntity;
+import org.apache.http.HttpResponse;
+import org.apache.http.NameValuePair;
+import org.apache.http.client.HttpClient;
+import org.apache.http.client.config.CookieSpecs;
+import org.apache.http.client.config.RequestConfig;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.utils.URIBuilder;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.util.EntityUtils;
+
+/*
+ * Sample code to demonstrate the use of the Full-archive Tweet counts endpoint
+ * */
+public class FullArchiveTweetCountsDemo {
+
+  // To set your enviornment variables in your terminal run the following line:
+  // export 'BEARER_TOKEN'='<your_bearer_token>'
+
+  public static void main(String args[]) throws IOException, URISyntaxException {
+    String bearerToken = System.getenv("BEARER_TOKEN");
+    if (null != bearerToken) {
+      //Replace the search term with a term of your choice
+      String response = getTweetCounts("from:TwitterDev", bearerToken);
+      System.out.println(response);
+    } else {
+      System.out.println("There was a problem getting your bearer token. Please make sure you set the BEARER_TOKEN environment variable");
+    }
+  }
+
+  /*
+   * This method calls the full-archive Tweet counts endpoint with a the search term passed to it as a query parameter
+   * */
+  private static String getTweetCounts(String searchString, String bearerToken) throws IOException, URISyntaxException {
+    String searchResponse = null;
+
+    HttpClient httpClient = HttpClients.custom()
+        .setDefaultRequestConfig(RequestConfig.custom()
+            .setCookieSpec(CookieSpecs.STANDARD).build())
+        .build();
+
+    URIBuilder uriBuilder = new URIBuilder("https://api.x.com/2/tweets/counts/all");
+    ArrayList<NameValuePair> queryParameters;
+    queryParameters = new ArrayList<>();
+    queryParameters.add(new BasicNameValuePair("query", searchString));
+    queryParameters.add(new BasicNameValuePair("granularity", "day"));
+    queryParameters.add(new BasicNameValuePair("start_time", "2021-01-01T00:00:00Z"));
+    uriBuilder.addParameters(queryParameters);
+
+    HttpGet httpGet = new HttpGet(uriBuilder.build());
+    httpGet.setHeader("Authorization", String.format("Bearer %s", bearerToken));
+    httpGet.setHeader("Content-Type", "application/json");
+
+    HttpResponse response = httpClient.execute(httpGet);
+    HttpEntity entity = response.getEntity();
+    if (null != entity) {
+      searchResponse = EntityUtils.toString(entity, "UTF-8");
+    }
+    return searchResponse;
+  }
+
+}

java/posts/QuoteTweetsDemo.java

@@ -0,0 +1,64 @@
+import org.apache.http.HttpEntity;
+import org.apache.http.HttpResponse;
+import org.apache.http.NameValuePair;
+import org.apache.http.client.HttpClient;
+import org.apache.http.client.config.CookieSpecs;
+import org.apache.http.client.config.RequestConfig;
+import org.apache.http.client.methods.HttpGet;
+import org.apache.http.client.utils.URIBuilder;
+import org.apache.http.impl.client.HttpClients;
+import org.apache.http.message.BasicNameValuePair;
+import org.apache.http.util.EntityUtils;
+
+import java.io.IOException;
+import java.net.URISyntaxException;
+import java.util.ArrayList;
+
+/*
+ * Sample code to demonstrate the use of the v2 Quote Tweets endpoint
+ * */
+public class QuoteTweetsDemo {
+
+  // To set your environment variables in your terminal run the following line:
+  // export 'BEARER_TOKEN'='<your_bearer_token>'
+
+  public static void main(String args[]) throws IOException, URISyntaxException {
+    final String bearerToken = System.getenv("BEARER_TOKEN");
+    if (null != bearerToken) {
+      //Replace with Tweet ID below
+      String response = getTweets(20, bearerToken);
+      System.out.println(response);
+    } else {
+      System.out.println("There was a problem getting your bearer token. Please make sure you set the BEARER_TOKEN environment variable");
+    }
+  }
+
+  /*
+   * This method calls the v2 Quote Tweets endpoint by Tweet ID
+   * */
+  private static String getTweets(int tweetId, String bearerToken) throws IOException, URISyntaxException {
+    String tweetResponse = null;
+
+    HttpClient httpClient = HttpClients.custom()
+        .setDefaultRequestConfig(RequestConfig.custom()
+            .setCookieSpec(CookieSpecs.STANDARD).build())
+        .build();
+
+    URIBuilder uriBuilder = new URIBuilder(String.format("https://api.x.com/2/tweets/%s/quote_tweets", tweetId));
+    ArrayList<NameValuePair> queryParameters;
+    queryParameters = new ArrayList<>();
+    queryParameters.add(new BasicNameValuePair("tweet.fields", "created_at"));
+    uriBuilder.addParameters(queryParameters);
+
+    HttpGet httpGet = new HttpGet(uriBuilder.build());
+    httpGet.setHeader("Authorization", String.format("Bearer %s", bearerToken));
+    httpGet.setHeader("Content-Type", "application/json");
+
+    HttpResponse response = httpClient.execute(httpGet);
+    HttpEntity entity = response.getEntity();
+    if (null != entity) {
+      tweetResponse = EntityUtils.toString(entity, "UTF-8");
+    }
+    return tweetResponse;
+  }
+}