X API v2

https://docs.x.com/x-api
Admin
X API v2 provides programmatic access to X's global conversation, including posts, users, spaces,...
Tokens:869,567
Snippets:5,213
Trust Score:10
Update:1 day ago
Show doc for...
Tokens:
Raw
### Go example for GET /2/users/{id}/pinned_lists

Source: https://docs.x.com/x-api/users/get-pinned-lists

Go example using net/http to make the GET request. Replace {id} and <token>.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/users/{id}/pinned_lists"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /2/connections

Source: https://docs.x.com/x-api/connections/get-connection-history

Go example using net/http to fetch connection history. Requires a Bearer token.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/connections"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /2/tweets/{id}/retweets

Source: https://docs.x.com/x-api/posts/get-reposts

Go example using net/http to send the GET request and print the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets/{id}/retweets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /2/users/{id}/liked_tweets

Source: https://docs.x.com/x-api/users/get-liked-posts

Go example using net/http to make the GET request. Replace {id} and <token>.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/users/{id}/liked_tweets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /2/compliance/jobs/{id}

Source: https://docs.x.com/x-api/compliance/get-compliance-job-by-id

Uses net/http to send a GET request with Bearer token. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/compliance/jobs/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby example for GET /2/connections

Source: https://docs.x.com/x-api/connections/get-connection-history

Ruby example using net/http to fetch connection history. Requires a Bearer token.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/connections")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Go example for GET /2/tweets/search/all

Source: https://docs.x.com/x-api/posts/search-all-posts

Go example using net/http to call the search all posts endpoint. Requires a Bearer token.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets/search/all"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /2/lists/{id}/tweets

Source: https://docs.x.com/x-api/lists/get-list-posts

Go example using net/http to call the endpoint. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/lists/{id}/tweets"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for GET /2/news/{id}

Source: https://docs.x.com/x-api/news/get-news-stories-by-id

Uses the net/http package to send a GET request. Requires an OAuth 2.0 bearer token.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/news/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for initialize media upload

Source: https://docs.x.com/x-api/media/initialize-media-upload

Uses net/http to send a POST request with the JSON payload and prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/upload/initialize"

	payload := strings.NewReader("{\n  \"additional_owners\": [\n    \"<string>\"\n  ],\n  \"shared\": true,\n  \"total_bytes\": 8589934592\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example output from xurl webhook start

Source: https://docs.x.com/x-api/webhooks/quickstart

Example output showing the server startup process, including ngrok tunnel setup and the webhook URL to use for registration.

```text
Starting webhook server with ngrok...
Enter your ngrok authtoken (leave empty to try NGROK_AUTHTOKEN env var):

Attempting to use NGROK_AUTHTOKEN environment variable for ngrok authentication.
Configuring ngrok to forward to local port: 8080
Ngrok tunnel established!
  Forwarding URL: https://<your-ngrok-subdomain>.ngrok-free.app -> localhost:8080

Use this URL for your X API webhook registration: https://<your-ngrok-subdomain>.ngrok-free.app/webhook

Starting local HTTP server to handle requests from ngrok tunnel...
```

--------------------------------

### Make the request with TypeScript xdk

Source: https://docs.x.com/x-api/posts/counts/quickstart/recent-tweet-counts

TypeScript example using the xdk Client to get recent Post counts. Logs each bucket's start time and tweet count, then the total. Requires a bearer token.

```typescript
import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Get recent Post counts
const response = await client.posts.countRecent({
  query: "from:XDevelopers",
  granularity: "day",
});

response.data?.forEach((bucket) => {
  console.log(`${bucket.start}: ${bucket.tweet_count} Posts`);
});

console.log(`Total: ${response.meta?.total_tweet_count}`);
```

--------------------------------

### Go example to follow a user

Source: https://docs.x.com/x-api/users/follow-user

Uses the net/http package to send a POST request with a JSON payload. It sets the required headers and prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/users/{id}/following"

	payload := strings.NewReader("{\n  \"target_user_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Make the request with Python xdk

Source: https://docs.x.com/x-api/posts/counts/quickstart/recent-tweet-counts

Python example using the xdk Client to get recent Post counts. Prints each bucket's start time and tweet count, then the total. Requires a bearer token.

```python
from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Get recent Post counts
response = client.posts.count_recent(
    query="from:XDevelopers",
    granularity="day"
)

for bucket in response.data:
    print(f"{bucket.start}: {bucket.tweet_count} Posts")

print(f"Total: {response.meta.total_tweet_count}")
```

--------------------------------

### CRC GET request example

Source: https://docs.x.com/x-api/webhooks/quickstart

Example of the GET request X sends to your webhook URL with a crc_token query parameter.

```http
GET https://your-webhook-url.com/webhook?crc_token=challenge_string
```

--------------------------------

### Go example for GET /2/spaces/by/creator_ids

Source: https://docs.x.com/x-api/spaces/get-spaces-by-creator-ids

Go example using net/http to call the endpoint. Replace <token> with a valid bearer token. Prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/spaces/by/creator_ids"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Example with expansions (Python SDK)

Source: https://docs.x.com/x-api/direct-messages/lookup/integrate

Python code using the xdk Client to list DM events with expansions, iterating over pages and printing event details. Requires a user access token.

```python
from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

# Get DM events with expansions
for page in client.dm_events.list(
    dm_event_fields=["created_at", "sender_id", "attachments"],
    expansions=["sender_id", "attachments.media_keys"],
    user_fields=["username", "profile_image_url"],
    media_fields=["url", "type"],
    max_results=100
):
    for event in page.data:
        print(f"Event: {event.event_type} - {event.text}")
```

--------------------------------

### URL structure examples

Source: https://docs.x.com/x-api/fundamentals/consistency

Concrete examples of v2 endpoint URLs, including getting a specific post, searching recent posts, getting a user by username, and getting a user's followers.

```text
/2/tweets/1234567890                    # Get a specific post
/2/tweets/search/recent                 # Search recent posts
/2/users/by/username/xdevelopers        # Get user by username
/2/users/1234/followers                 # Get user's followers
```

--------------------------------

### Create Activity Subscription (Go)

Source: https://docs.x.com/x-api/activity/create-x-activity-subscription

Go example using net/http to POST to /2/activity/subscriptions. Requires a bearer token and a JSON body. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/activity/subscriptions"

	payload := strings.NewReader("{\n  \"filter\": {\n    \"keyword\": \"<string>\",\n    \"qualifiers\": {},\n    \"user_id\": \"<string>\"\n  },\n  \"expires_at\": \"<string>\",\n  \"tag\": \"<string>\",\n  \"webhook_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### INIT response example

Source: https://docs.x.com/x-api/media/quickstart/media-upload-chunked

Shows the JSON response from the initialize endpoint, containing the media_id, media_key, and expiration time in seconds.

```json
{
  "data": {
    "id": "1880028106020515840",
    "media_key": "13_1880028106020515840",
    "expires_after_secs": 86400
  }
}
```

--------------------------------

### Go example for bookmarks by folder ID

Source: https://docs.x.com/x-api/users/get-bookmarks-by-folder-id

Go example using net/http to GET bookmarks from a folder. Requires an OAuth 2.0 user token. Replace {id} and {folder_id} with actual values.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/users/{id}/bookmarks/folders/{folder_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Go example to update X activity subscription

Source: https://docs.x.com/x-api/activity/update-x-activity-subscription

Uses net/http to send a PUT request with a JSON string body. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/activity/subscriptions/{subscription_id}"

	payload := strings.NewReader("{\n  \"tag\": \"<string>\",\n  \"webhook_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

--------------------------------

### Ruby example for GET /2/users/{id}/pinned_lists

Source: https://docs.x.com/x-api/users/get-pinned-lists

Ruby example using Net::HTTP to make the GET request. Replace {id} and <token>.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/users/{id}/pinned_lists")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Java Unirest example for GET /2/users/{id}/pinned_lists

Source: https://docs.x.com/x-api/users/get-pinned-lists

Java example using Unirest to make the GET request. Replace {id} and <token>.

```java
HttpResponse<String> response = Unirest.get("https://api.x.com/2/users/{id}/pinned_lists")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Go example for GET /2/lists/{id}

Source: https://docs.x.com/x-api/lists/get-list-by-id

Uses the net/http package to send a GET request with an Authorization header. Reads and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/lists/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### PHP cURL example for GET /2/users/{id}/pinned_lists

Source: https://docs.x.com/x-api/users/get-pinned-lists

PHP example using cURL to make the GET request. Replace {id} and <token>.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/users/{id}/pinned_lists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Go example for create media metadata

Source: https://docs.x.com/x-api/media/create-media-metadata

Uses net/http to send a POST request with a JSON payload. Prints the response body. Requires an OAuth 2.0 user token.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/metadata"

	payload := strings.NewReader("{\n  \"id\": \"<string>\",\n  \"metadata\": {\n    \"allow_download_status\": {\n      \"allow_download\": true\n    },\n    \"audience_policy\": {},\n    \"geo_restrictions\": {},\n    \"sensitive_media_warning\": {}\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Java Unirest example for GET /2/users/{id}/liked_tweets

Source: https://docs.x.com/x-api/users/get-liked-posts

Java example using Unirest to make the GET request. Replace {id} and <token>.

```java
HttpResponse<String> response = Unirest.get("https://api.x.com/2/users/{id}/liked_tweets")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### PHP cURL example for GET /2/users/{id}/liked_tweets

Source: https://docs.x.com/x-api/users/get-liked-posts

PHP example using cURL to make the GET request. Replace {id} and <token>.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/users/{id}/liked_tweets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Example with expansions (TypeScript SDK)

Source: https://docs.x.com/x-api/direct-messages/lookup/integrate

TypeScript code using the @xdevplatform/xdk Client to list DM events with expansions, iterating over pages and logging event details. Requires a user access token.

```typescript
import { Client } from "@xdevplatform/xdk";

const client = new Client({ accessToken: "YOUR_USER_ACCESS_TOKEN" });

const paginator = client.dmEvents.list({
  dmEventFields: ["created_at", "sender_id", "attachments"],
  expansions: ["sender_id", "attachments.media_keys"],
  userFields: ["username", "profile_image_url"],
  mediaFields: ["url", "type"],
  maxResults: 100,
});

for await (const page of paginator) {
  page.data?.forEach((event) => {
    console.log(`Event: ${event.event_type} - ${event.text}`);
  });
}
```

--------------------------------

### Java Unirest example for GET /2/tweets/{id}/retweets

Source: https://docs.x.com/x-api/posts/get-reposts

Java example using Unirest to make the GET request and return the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://api.x.com/2/tweets/{id}/retweets")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Go GET /2/users/{id}

Source: https://docs.x.com/x-api/users/get-user-by-id

Go example using net/http to fetch user data. Replace {id} and <token> as needed.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/users/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby Net::HTTP example for GET /2/users/{id}/liked_tweets

Source: https://docs.x.com/x-api/users/get-liked-posts

Ruby example using Net::HTTP to make the GET request. Replace {id} and <token>.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/users/{id}/liked_tweets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Ruby Net::HTTP example for GET /2/tweets/{id}/retweets

Source: https://docs.x.com/x-api/posts/get-reposts

Ruby example using Net::HTTP to send the GET request and print the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/tweets/{id}/retweets")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

--------------------------------

### Python xdk client example with fields and expansions

Source: https://docs.x.com/x-api/posts/lookup/integrate

Uses the xdk Python client to fetch a post with additional fields and expansions. Prints the response data and includes expanded user and media objects.

```python
from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Get a Post with additional fields and expansions
response = client.posts.get(
    "1234567890",
    tweet_fields=["created_at", "public_metrics", "entities"],
    expansions=["author_id", "attachments.media_keys"],
    user_fields=["username", "verified"],
    media_fields=["url", "type"]
)

print(response.data)
print(response.includes)  # Contains expanded user and media objects
```

--------------------------------

### Go example for upload media

Source: https://docs.x.com/x-api/media/upload-media

Uses net/http to POST JSON to the upload endpoint. Prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/upload"

	payload := strings.NewReader("{\n  \"media\": \"<string>\",\n  \"additional_owners\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

--------------------------------

### PHP cURL example for GET /2/tweets/{id}/retweets

Source: https://docs.x.com/x-api/posts/get-reposts

PHP example using cURL to make the GET request. It sets the Authorization header and prints the response or an error.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/tweets/{id}/retweets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

--------------------------------

### Initialize upload (INIT) with cURL

Source: https://docs.x.com/x-api/media/quickstart/media-upload-chunked

Starts the upload session by sending a JSON body to POST /2/media/upload/initialize. Requires a user access token and sets media_type, total_bytes, and media_category. Use tweet_video for a regular Post or amplify_video for Ads creatives.

```shell
curl -X POST "https://api.x.com/2/media/upload/initialize" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "media_type": "video/mp4",
    "total_bytes": 1048576,
    "media_category": "tweet_video"
  }'
```

--------------------------------

### Get List Members with curl

Source: https://docs.x.com/x-api/lists/list-members/introduction

Example request to get members of a list using the GET /2/lists/:id/members endpoint. Requires a bearer token for authentication.

```bash
curl "https://api.x.com/2/lists/1234567890/members?\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"
```

--------------------------------

### 200 response example for Get Users by IDs

Source: https://docs.x.com/x-api/users/get-users-by-ids

Example JSON response returned by the /2/users endpoint when the request is successful.

```json
{
  "data": [
    {
      "active_follower_count": 123,
      "affiliation": {
        "badge_url": "<string>",
        "description": "<string>",
        "url": "<string>",
        "user_id": [
          "<string>"
        ]
      },
      "confirmed_email": "<string>",
      "connection_status": [
        "blocking"
      ],
      "created_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "entities": {
        "description": {
          "cashtags": [
            {
              "end": 123,
              "start": 123,
              "tag": "<string>"
            }
          ],
          "hashtags": [
            {
              "end": 123,
              "start": 123,
              "tag": "<string>"
            }
          ],
          "mentions": [
            {
              "end": 123,
              "start": 123,
              "username": "<string>",
              "id": "<string>"
            }
          ],
          "urls": [
            {
              "end": 123,
              "start": 123,
              "url": "<string>",
              "description": "<string>",
              "display_url": "<string>",
              "expanded_url": "<string>",
              "images": [
                {
                  "height": 123,
                  "url": "<string>",
                  "width": 123
                }
              ],
              "media_key": "<string>",
              "status": 123,
              "title": "<string>",
              "unwound_url": "<string>"
            }
          ]
        },
        "url": {
          "urls": [
            {
              "end": 123,
              "start": 123,
              "url": "<string>",
              "description": "<string>",
              "display_url": "<string>",
              "expanded_url": "<string>",
              "images": [
                {
                  "height": 123,
                  "url": "<string>",
                  "width": 123
                }
              ],
              "media_key": "<string>",
              "status": 123,
              "title": "<string>",
              "unwound_url": "<string>"
            }
          ]
        }
      },
      "id": "<string>",
      "is_identity_verified": true,
      "location": "<string>",
      "most_recent_post_id": "<string>",
      "name": "<string>",
      "parody": true,
      "pinned_post_id": "<string>",
      "profile_banner_url": "<string>",
      "profile_image_url": "<string>",
      "protected": true,
      "public_metrics": {
        "followers_count": 123,
        "following_count": 123,
        "listed_count": 123,
        "post_count": 123,
        "like_count": 123,
        "media_count": 123
      },
      "receives_your_dm": true,
      "subscriber_count": 123,
      "subscribes_to_you": true,
      "subscription": {
        "subscribes_to_you": true
      },
      "subscription_type": "<string>",
      "url": "<string>",
      "username": "<string>",
      "verified": true,
      "verified_followers_count": 123
    }
  ]
}
```

--------------------------------

### Go example for liking users

Source: https://docs.x.com/x-api/posts/get-liking-users

Go program using net/http to send a GET request with the authorization header and print the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets/{id}/liking_users"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Java Unirest example for GET /2/tweets/search/recent

Source: https://docs.x.com/x-api/posts/search-recent-posts

Java example using Unirest to call the Search Posts Recent endpoint. It sends a GET request with an Authorization header and returns the response as a string. Replace <token> with your actual token.

```java
HttpResponse<String> response = Unirest.get("https://api.x.com/2/tweets/search/recent")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Initialize upload (INIT) with Python xdk

Source: https://docs.x.com/x-api/media/quickstart/media-upload-chunked

Uses the xdk Python client to call client.media.initialize_upload with the same parameters as the cURL example. Prints the returned media_id.

```python
from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

response = client.media.initialize_upload(
    media_type="video/mp4",
    total_bytes=1048576,
    media_category="tweet_video",
)

media_id = response.data.id
print(f"Media ID: {media_id}")
```

--------------------------------

### Go example for GET /2/tweets/search/recent

Source: https://docs.x.com/x-api/posts/search-recent-posts

Go example using net/http to call the Search Posts Recent endpoint. It creates a GET request with an Authorization header, executes it, and prints the response body. Replace <token> with your actual token.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets/search/recent"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

--------------------------------

### Create Post with media (Python xdk)

Source: https://docs.x.com/x-api/media/quickstart/media-upload-chunked

Use this Python example with the xdk client to create a Post with the uploaded media. It requires a user access token and the media ID from the upload. The response will be 403 Forbidden if the video exceeds the user's duration cap.

```python
from xdk import Client

client = Client(bearer_token="YOUR_USER_ACCESS_TOKEN")

response = client.posts.create(
    text="Check out this video!",
    media={"media_ids": [media_id]},
)

print(f"Posted: {response.data.id}")
```

--------------------------------

### JavaScript fetch example for GET /2/tweets/search/recent

Source: https://docs.x.com/x-api/posts/search-recent-posts

JavaScript example using fetch to call the Search Posts Recent endpoint. It sends a GET request with an Authorization header and logs the JSON response. Replace <token> with your actual token.

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.x.com/2/tweets/search/recent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Python SDK with fields and expansions

Source: https://docs.x.com/x-api/posts/search/quickstart/recent-search

Use the XDK Python client to search with additional fields and expansions. The example prints the first 50 characters of each post and its like count.

```python
from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Search with fields and expansions
for page in client.posts.search_recent(
    query="python lang:en -is:retweet",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"],
    max_results=10
):
    for post in page.data:
        print(f"{post.text[:50]}... - Likes: {post.public_metrics.like_count}")
```

--------------------------------

### Go example for Add Lists Member

Source: https://docs.x.com/x-api/lists/add-list-member

Uses net/http to send a POST request with a JSON string body. Adds Authorization and Content-Type headers and prints the response body.

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/lists/{id}/members"

	payload := strings.NewReader("{\n  \"user_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

```

--------------------------------

### Go example for downloading compliance job results

Source: https://docs.x.com/x-api/compliance/download-compliance-job-results

Uses net/http to send a GET request with a Bearer token and prints the response body.

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/compliance/jobs/{id}/download"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```
Tokens:
Raw