Twitter/X User Timeline API

x402

Twitter/X User Timeline API is a paid API for AI agents from twitter.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14, last successful call 2026-08-06).

Returns a paginated timeline of posts (tweets) from a specified public X (Twitter) user account.

Price / call$0.005

Seller volume →—

Success100%

StatusUnknown

How this service works

Get a paginated timeline of posts from an X user.

Output

Returns a JSON object containing an array of post/tweet objects with full tweet metadata, a total result_count integer, a queried_at ISO 8601 timestamp, and an optional opaque cursor string for fetching the next page of results.

Example use cases

Monitoring a brand's Twitter activity

“Fetch the latest posts from @Nike's X timeline so I can track what they've been saying this week.”

Research on a public figure's statements

“Get me the recent tweets from @AOC on X — I want to see her posts from the last few days for a research summary.”

Competitive intelligence feed

“Pull the tweet timeline for @OpenAI so I can keep tabs on what they're publicly announcing on X.”

Technical details

Endpoint

GEThttps://twitter.use.x402atlas.com/user-tweets

When to prefer

Use this endpoint when you need the chronological post history of a specific known X user (by username). Prefer this over search endpoints when you want all posts from one user rather than topic-filtered results, and over the replies or media-specific endpoints when you want the full general timeline including text posts.

Side effects

Invalid or nonexistent username returns empty data or an error
Private/protected accounts return no tweets
Rate limiting from the underlying X API may cause failures or empty responses
Malformed username (wrong pattern) rejected by input validation
Account suspended or deactivated returns no results

Input

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

Schema · Response

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

Reviews

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"

Example use cases

Monitoring a brand's Twitter activity

“Fetch the latest posts from @Nike's X timeline so I can track what they've been saying this week.”

Research on a public figure's statements

“Get me the recent tweets from @AOC on X — I want to see her posts from the last few days for a research summary.”

Competitive intelligence feed

“Pull the tweet timeline for @OpenAI so I can keep tabs on what they're publicly announcing on X.”

Technical details

Endpoint

GEThttps://twitter.use.x402atlas.com/user-tweets

When to prefer

Side effects

Invalid or nonexistent username returns empty data or an error
Private/protected accounts return no tweets
Rate limiting from the underlying X API may cause failures or empty responses
Malformed username (wrong pattern) rejected by input validation
Account suspended or deactivated returns no results

Input

Schema · Request body

Field	Type	Description
inputrequired	object
output	object

Output

Schema · Response

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