# Twitter/X API

**Twitter/X API** is an independently documented x402 Atlas bridge at https://twitter.use.x402atlas.com.
This document describes only this bridge; it does not aggregate routes, schemas,
or content from any other bridge.

## How payment works

Paid operations use the [x402 payment protocol](https://x402.org) and settle in
USDC. Atlas supports deployments on Base, Polygon, and Arbitrum, plus configured
Solana networks. This bridge currently advertises Arbitrum One (`eip155:42161`), Base (`eip155:8453`), Polygon (`eip155:137`), Solana mainnet (`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`).

1. Send the HTTP request without a payment signature.
2. Read the `402 Payment Required` response. Its `accepts` entries are the
   authoritative network, asset, amount, and recipient options for that call.
3. Select an option, sign it with an x402-compatible wallet or SDK, and repeat
   the request with the `PAYMENT-SIGNATURE` header. The successful response is
   returned after verification and settlement.

TypeScript clients can automate the challenge, signing, and retry flow with
[`x402-fetch`](https://www.npmjs.com/package/x402-fetch) or
[`x402-axios`](https://www.npmjs.com/package/x402-axios). Fund a dedicated
wallet only with the working USDC balance it needs and keep that key separate
from treasury accounts.

## Pricing

Atlas route prices start at $0.005 per successful call. This bridge's fallback
price is $0.005; operations below state their exact configured price in
`x-x402` and `x-payment-info`. The live `402` challenge remains authoritative.

## Worked payment example

Request one documented operation without a signature to inspect its live terms:

```bash
curl -i 'https://twitter.use.x402atlas.com/autocomplete?query=bill'
# HTTP/1.1 402 Payment Required
# Read accepts[].network, asset, amount, and payTo from this response.
```

Sign one accepted option and repeat the identical request with the
`PAYMENT-SIGNATURE` header. Do not invent or cache payment terms; read them from
the current challenge.

## Use this API

- Interactive reference: https://twitter.use.x402atlas.com/docs
- OpenAPI 3.1 specification: https://twitter.use.x402atlas.com/openapi.json
- Agent-readable route corpus: https://twitter.use.x402atlas.com/llms.txt
- Endpoint index: https://twitter.use.x402atlas.com/index.json

Use the operation schemas and examples below to construct requests. Copy the
server URL, path, method, parameters, and request body from the operation you
want to call. Path and query examples are concrete and can be used directly.

## Atlas response metadata

Successful JSON responses include an additive top-level `_atlas` block, kept
separate from the bridge's data fields. `_atlas.docs` links this bridge's
`/llms.txt` corpus. `_atlas.related` suggests adjacent APIs, each with a callable
`url`, its own `docs` link, and a short `summary`. Suppress this block by sending
`X-Atlas-Meta: none` or by adding `?_atlas=0` to the request.

## Errors and compatibility

Validation failures use HTTP `400`. Paid operations may return `402` before
dispatch. Upstream and internal failures use the documented `5xx` responses.
Clients should rely on documented fields and tolerate additive response fields,
including `_atlas` unless they explicitly opt out.

## Protocol reference

- x402 protocol and SDKs: https://x402.org

## Twitter/X API

Docs: https://twitter.use.x402atlas.com/docs · OpenAPI: https://twitter.use.x402atlas.com/openapi.json

### GET /autocomplete

Get X search suggestions for a partial query.

Return X autocomplete suggestions for a partial free-text `query`, including available user, hashtag, list, topic and event suggestion groups.

**Price:** $0.006 per call.

Parameters:
- `query` (required, string) — Partial text to complete; minLength: `1`, maxLength: `200`; example: `"bill"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/autocomplete?query=bill'
```

Response example:

```json
{
  "data": {
    "num_results": 10,
    "query": "bill",
    "users": [
      {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    ]
  },
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /community-details

Get complete public information for an X community.

Return the complete provider object for one X community, including description, policies, membership counts, rules and viewer-independent metadata.

**Price:** $0.006 per call.

Parameters:
- `community_id` (required, string) — Decimal X community identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1493264213904560130"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/community-details?community_id=1493264213904560130'
```

Response example:

```json
{
  "data": {
    "description": "A community for technology discussions",
    "member_count": 120000,
    "name": "Technology",
    "rest_id": "1493264213904560130"
  },
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /community-media

Get media posts from an X community.

Return one page of media-bearing posts from an X community, preserving the provider's nested media entities. Use `cursor` to continue.

**Price:** $0.006 per call.

Parameters:
- `community_id` (required, string) — Decimal X community identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1493264213904560130"`
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/community-media?community_id=1493264213904560130'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### POST /community-members

Get members of an X community.

POST a JSON body containing `community_id` to return one page of community members and their roles. The response may include an opaque next-page cursor.

**Price:** $0.006 per call.

Body fields:
- `community_id` (required, string) — Decimal X community identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1493264213904560130"`

Request body (`application/json`):

```json
{
  "community_id": "1493264213904560130"
}
```

Example:

```sh
curl --request POST 'https://twitter.use.x402atlas.com/community-members' --header 'Content-Type: application/json' --data '{"community_id":"1493264213904560130"}'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "community_role": "Admin",
      "is_blue_verified": true,
      "name": "Mukul Sharma",
      "rest_id": "2901317886",
      "screen_name": "stufflistings"
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /community-tweets

Get top or latest posts from an X community.

Return one page of posts from an X community. `sort` may be `top` or `latest`; pass `cursor` to continue.

**Price:** $0.006 per call.

Parameters:
- `community_id` (required, string) — Decimal X community identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1493264213904560130"`
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `sort` (optional, string) — Community timeline order; allowed: ["top","latest"]

Example:

```sh
curl 'https://twitter.use.x402atlas.com/community-tweets?community_id=1493264213904560130'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /list-details

Get complete public information for an X list.

Return the complete provider object for one public X list, including its name, description, owner, member count and subscriber count.

**Price:** $0.006 per call.

Parameters:
- `list_id` (required, string) — Decimal X list identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1309482935804932102"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/list-details?list_id=1309482935804932102'
```

Response example:

```json
{
  "data": {
    "description": "Technology accounts and news",
    "id_str": "1309482935804932102",
    "member_count": 120,
    "name": "Technology",
    "subscriber_count": 4500
  },
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /list-followers

Get followers of a public X list.

Return one page of public user objects following an X list. Use `cursor` for the next page.

**Price:** $0.006 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `list_id` (required, string) — Decimal X list identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1309482935804932102"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/list-followers?list_id=1309482935804932102'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "description": "Sharing things I learn.",
      "followers_count": 65000000,
      "id": 50393960,
      "name": "Bill Gates",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/example_normal.jpg",
      "screen_name": "BillGates",
      "verified": true
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /list-members

Get members of a public X list.

Return one page of public user objects belonging to an X list. Use `cursor` for the next page.

**Price:** $0.006 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `list_id` (required, string) — Decimal X list identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1309482935804932102"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/list-members?list_id=1309482935804932102'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "description": "Sharing things I learn.",
      "followers_count": 65000000,
      "id": 50393960,
      "name": "Bill Gates",
      "profile_image_url_https": "https://pbs.twimg.com/profile_images/example_normal.jpg",
      "screen_name": "BillGates",
      "verified": true
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /list-tweets

Get posts from a public X list.

Return one page of posts from accounts in a public X list. Use `cursor` for the next page.

**Price:** $0.006 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `list_id` (required, string) — Decimal X list identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1309482935804932102"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/list-tweets?list_id=1309482935804932102'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /locations

List the geographic locations available for Twitter/X trends, including WOEIDs, place types and country details.

List every geographic location for which X exposes trends. The route takes no parameters and returns a normalized `locations` array. Each entry contains its numeric Yahoo Where On Earth ID (`woeid`), display `name`, place type, optional parent WOEID, country and ISO country code. Pass a returned `woeid` to `/trends`. The obsolete upstream Yahoo URL is deliberately omitted. `Worldwide` uses WOEID `1` and has no country code.

**Price:** $0.006 per call.

Example:

```sh
curl 'https://twitter.use.x402atlas.com/locations'
```

Response example:

```json
{
  "location_count": 2,
  "locations": [
    {
      "name": "Worldwide",
      "place_type": "Supername",
      "place_type_code": 19,
      "woeid": 1
    },
    {
      "country": "United States",
      "country_code": "US",
      "name": "Los Angeles",
      "parent_woeid": 23424977,
      "place_type": "Town",
      "place_type_code": 7,
      "woeid": 2442047
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /search

Search Twitter/X with structured filters or raw advanced-search syntax. Returns up to 20 normalized tweets with full text, author details, engagement metrics and a pagination cursor.

Run an X advanced-search query from structured filters and get back one normalized page of up to 20 tweets. **At least one** of `words`, `phrase`, `any_words`, `hashtags`, `from`, `to`, `mentioning`, or `search_query` is required — a request with none of these returns `400`. Optional filters: `none_words`, `filter` (`replies`,`links`,`quote`,`media`,`images`,`videos`), `min_likes`/`min_retweets`/`min_replies` (digits only), `since`/`until` (`YYYY-MM-DD`), `within_time` (e.g. `3h`, `2d`), `near`, `since_id`, `max_id`, `type` (`top` default, `latest`, or `media`), and `cursor` for pagination; `search_query` (aliases `query`, `q`) is a raw-syntax escape hatch merged with the rest. List-valued params accept comma- or space-separated values. Each tweet carries full `text`, `created_at` (RFC3339), engagement metrics (`likes`, `retweets`, `replies`, `quotes`, `bookmarks`, `views`) and a nested `author` profile; the response also echoes the assembled `query` (handy for debugging filter combinations) and a `cursor` for the next page. A search with zero matches is a `200` with `tweets: []`, not an error — page through with `cursor`, or backward by `max_id`.

**Price:** 0.005 per call.

Parameters:
- `any_words` (optional, string) — Any of these words
- `cursor` (optional, string) — Pagination cursor; maxLength: `2048`
- `filter` (optional, string) — Content filters: replies, links, quote, media, images, videos; pattern: `"^(replies|links|quote|media|images|videos)([,\\s]+(replies|links|quote|media|images|videos))*$"`
- `from` (optional, string) — Tweets from this username
- `hashtags` (optional, string) — Filter by hashtags
- `max_id` (optional, string) — Tweets at or before this tweet ID; pattern: `"^[0-9]+$"`
- `mentioning` (optional, string) — Tweets mentioning this username
- `min_likes` (optional, integer) — Minimum like count
- `min_replies` (optional, integer) — Minimum reply count
- `min_retweets` (optional, integer) — Minimum retweet count
- `near` (optional, string) — Tweets near this location
- `none_words` (optional, string) — Exclude these words
- `phrase` (optional, string) — Exact phrase match
- `q` (optional, string) — Short alias of search_query; maxLength: `512`
- `query` (optional, string) — Alias of search_query; maxLength: `512`
- `search_query` (optional, string) — Raw X advanced search query; maxLength: `512`
- `since` (optional, string) — Start date (YYYY-MM-DD); pattern: `"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"`
- `since_id` (optional, string) — Tweets after this tweet ID; pattern: `"^[0-9]+$"`
- `to` (optional, string) — Tweets replying to this username
- `type` (optional, string) — Result mode: top, latest or media; allowed: ["top","latest","media"], default: `"top"`
- `until` (optional, string) — End date (YYYY-MM-DD); pattern: `"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"`
- `within_time` (optional, string) — Recent time window: digits plus s, m, h or d; pattern: `"^[0-9]+[smhd]$"`
- `words` (optional, string) — All these words must appear; example: `"bitcoin"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/search?words=bitcoin'
```

Response example:

```json
{
  "cursor": "DAACCgACHMe1FCaAJxAKAAMcx7UU…",
  "queried_at": "2026-07-05T12:00:00Z",
  "query": "from:@PancakeSwap filter:replies",
  "tweet_count": 1,
  "tweets": [
    {
      "author": {
        "avatar": "https://pbs.twimg.com/profile_images/2004910939959967744/wr7-zpVh_normal.jpg",
        "description": "Everyone's favorite DEX. Swap, trade, and earn across 10+ chains.",
        "followers": 2132825,
        "id": "1305349277422477313",
        "name": "PancakeSwap",
        "screen_name": "PancakeSwap",
        "verified": true
      },
      "bookmarks": 0,
      "conversation_id": "2071965667491000381",
      "created_at": "2026-06-30T14:34:45Z",
      "id": "2071965671001608665",
      "is_quote": false,
      "lang": "en",
      "likes": 16,
      "quotes": 0,
      "replies": 1,
      "retweets": 2,
      "text": "Stack your tokenized assets ⬇️\nhttps://t.co/peohoKiMyQ",
      "urls": [
        "https://pancakeswap.finance/stocks"
      ],
      "views": 3534
    }
  ],
  "type": "top"
}
```

### GET /search-communities

Search public X communities by query.

Search public X communities by free-text `query`. Results include community identity and membership metadata; use `cursor` for the next page.

**Price:** $0.006 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `query` (required, string) — Community search text; minLength: `1`, maxLength: `200`; example: `"technology"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/search-communities?query=technology'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "description": "A community for technology discussions",
      "member_count": 120000,
      "name": "Technology",
      "rest_id": "1493264213904560130"
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /search-lists

Search public X lists by query.

Search public X lists by free-text `query` and return matching list cards with their public identifiers and links.

**Price:** $0.006 per call.

Parameters:
- `query` (required, string) — List search text; minLength: `1`, maxLength: `200`; example: `"technology"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/search-lists?query=technology'
```

Response example:

```json
{
  "data": [
    {
      "object_id": "1309482935804932102",
      "result_contexts": [
        "Technology"
      ],
      "url": "https://x.com/i/lists/1309482935804932102"
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /trends

Twitter/X trends right now — the ranked list of trending topics and hashtags on Twitter/X for any country by ISO code (US, GB, JP, worldwide) or a city by WOEID, each with post count, search query and related trends. For trend tracking, social listening and viral-topic discovery.

Return the current ranked X trends for one geographic scope. `country` selects a country by ISO 3166-1 alpha-2 code (`US`, `GB`, `JP`, ...) or `worldwide`; it is required, and an omitted `country` defaults to `US`. For a city, pass the optional `woeid` (a positive integer from `/locations`), which takes precedence over `country`. The response echoes the effective scope in `query` (`country=US` or `woeid=2442047`). Each normalized trend contains its rank, display name, reusable X search query, optional context and numeric post count, plus related names in `grouped_trends`. Provider deep links and opaque tracking parameters are removed. Post counts such as `17.1K posts` are normalized to integers; when X does not publish a count, `post_count` is omitted.

**Price:** $0.03 per call.

Parameters:
- `country` (required, string) — ISO 3166-1 alpha-2 country code or worldwide; defaults to US when omitted; allowed: ["worldwide","AE","AR","AT","AU","BE","BH","BR","BY","CA","CH","CL","CO","DE","DK","DO","DZ","EC","EG","ES","FR","GB","GH","GR","GT","ID","IE","IL","IN","IT","JO","JP","KE","KR","KW","LB","LV","MX","MY","NG","NL","NO","NZ","OM","PA","PE","PH","PK","PL","PR","PT","QA","RU","SA","SE","SG","TH","TR","UA","US","VE","VN","ZA"]; example: `"US"`
- `woeid` (optional, integer) — City scope from /locations; overrides country; minimum: `1`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/trends?country=US'
```

Response example:

```json
{
  "queried_at": "2026-07-26T12:00:00Z",
  "query": "country=US",
  "trend_count": 2,
  "trends": [
    {
      "context": "Trending in United States",
      "grouped_trends": [],
      "name": "#FogoChain",
      "post_count": 17100,
      "rank": 1,
      "search_query": "#FogoChain"
    },
    {
      "context": "Business and finance · Trending",
      "grouped_trends": [
        "Greg Abel",
        "CEO of Berkshire Hathaway"
      ],
      "name": "Warren Buffett",
      "post_count": 21600,
      "rank": 2,
      "search_query": "\"Warren Buffett\""
    }
  ],
  "woeid": 23424977
}
```

### GET /tweet-details

Get the complete public data for one X post.

Return the provider's complete post object for a decimal `tweet_id`, including text, author, engagement, conversation and entity fields.

**Price:** $0.006 per call.

Parameters:
- `tweet_id` (required, string) — Decimal X post identifier; maxLength: `25`, pattern: `"^[0-9]{1,25}$"`; example: `"1903602810652082591"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/tweet-details?tweet_id=1903602810652082591'
```

Response example:

```json
{
  "data": {
    "created_at": "Sun Mar 23 12:00:00 +0000 2025",
    "favorite_count": 120,
    "full_text": "Example X post",
    "id_str": "1903602810652082591",
    "reply_count": 8,
    "retweet_count": 15,
    "user": {
      "id_str": "50393960",
      "name": "Bill Gates",
      "screen_name": "BillGates"
    }
  },
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /user-about

Get the extended About information for a public X user.

Return X's extended About profile object for one username, including the available account metadata and verification information.

**Price:** $0.005 per call.

Parameters:
- `username` (required, string) — X username, with or without a leading @; maxLength: `16`, pattern: `"^@?[A-Za-z0-9_]{1,15}$"`; example: `"BillGates"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/user-about?username=BillGates'
```

Response example:

```json
{
  "data": {
    "about_profile": {
      "source": "profile"
    },
    "core": {
      "name": "Bill Gates",
      "screen_name": "BillGates"
    },
    "is_blue_verified": true,
    "rest_id": "50393960"
  },
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /user-details

Twitter/X user profile lookup by username — the full public profile as JSON: display name, bio, follower and following counts, verification status, avatar, location, join date and pinned post. For influencer vetting, audience research and account enrichment.

Return the complete provider profile object for one public X username, including identity, biography, verification, counts, avatar and relationship fields. The nested `data` object is preserved because X adds profile fields over time.

**Price:** $0.005 per call.

Parameters:
- `username` (required, string) — X username, with or without a leading @; maxLength: `16`, pattern: `"^@?[A-Za-z0-9_]{1,15}$"`; example: `"BillGates"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/user-details?username=BillGates'
```

Response example:

```json
{
  "data": {
    "core": {
      "name": "Bill Gates",
      "screen_name": "BillGates"
    },
    "is_blue_verified": true,
    "legacy": {
      "description": "Sharing things I learn.",
      "followers_count": 65000000
    },
    "rest_id": "50393960"
  },
  "queried_at": "2026-07-26T12:00:00Z"
}
```

### GET /user-highlights

Get the highlighted posts selected on an X user profile.

Return one page of posts highlighted on a public X profile. The route supports the provider's opaque pagination cursor.

**Price:** $0.005 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `username` (required, string) — X username, with or without a leading @; maxLength: `16`, pattern: `"^@?[A-Za-z0-9_]{1,15}$"`; example: `"BillGates"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/user-highlights?username=BillGates'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /user-media

Get a paginated timeline of media posts from an X user.

Return one page of media-bearing posts from a public X user, including the provider's nested media entities and pagination cursor.

**Price:** $0.005 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `username` (required, string) — X username, with or without a leading @; maxLength: `16`, pattern: `"^@?[A-Za-z0-9_]{1,15}$"`; example: `"BillGates"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/user-media?username=BillGates'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /user-replies

Get a paginated timeline of replies from an X user.

Return one page of replies and conversation posts from a public X user. Pass the returned `cursor` to continue.

**Price:** $0.005 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `username` (required, string) — X username, with or without a leading @; maxLength: `16`, pattern: `"^@?[A-Za-z0-9_]{1,15}$"`; example: `"BillGates"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/user-replies?username=BillGates'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```

### GET /user-tweets

Get a paginated timeline of posts from an X user.

Return one page of posts published by a public X user. Pass the returned `cursor` to retrieve the next page.

**Price:** $0.005 per call.

Parameters:
- `cursor` (optional, string) — Opaque pagination cursor from the previous response; minLength: `1`, maxLength: `4096`
- `username` (required, string) — X username, with or without a leading @; maxLength: `16`, pattern: `"^@?[A-Za-z0-9_]{1,15}$"`; example: `"BillGates"`

Example:

```sh
curl 'https://twitter.use.x402atlas.com/user-tweets?username=BillGates'
```

Response example:

```json
{
  "cursor": "NEXT_PAGE_CURSOR",
  "data": [
    {
      "created_at": "Sun Mar 23 12:00:00 +0000 2025",
      "favorite_count": 120,
      "full_text": "Example X post",
      "id_str": "1903602810652082591",
      "reply_count": 8,
      "retweet_count": 15,
      "user": {
        "id_str": "50393960",
        "name": "Bill Gates",
        "screen_name": "BillGates"
      }
    }
  ],
  "queried_at": "2026-07-26T12:00:00Z",
  "result_count": 1
}
```