# agdata Twitter/X Scraper

> agdata Twitter/X Scraper is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Fetches tweets from a Twitter/X account profile or keyword search query, returning structured tweet and author metadata, with no X developer account required.

## Facts

- Endpoint: POST https://agdata.shveik.dev/x402/twitter?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-twitter-x-scraper-f137e450
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MWZoWRwtBtY4nYJ_O5pvg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agdata-twitter-x-scraper-f137e450 -d '<json body>'
```

Example prompt: Pull the last 10 tweets from NASA's Twitter account and show me the text, likes, and view counts for each one.

## When to prefer this

Choose this endpoint when you need Twitter/X tweet data without setting up an X developer account or managing OAuth tokens. It is ideal for agents that need quick, pay-per-call access to public tweet content for either a specific account's timeline or keyword-based search, at low cost ($0.01 USDC per call). Prefer alternatives when you need real-time streaming, bulk historical data, or private account content.

## Known failure modes

- Invalid or suspended Twitter handle returns empty results or error
- Search query returning no matching tweets returns empty array
- Limit value outside 1-20 range is clamped to valid bounds
- Private or protected account tweets are not accessible
- Rate limiting or upstream Twitter blocking may cause transient failures
- Malformed JSON body returns 400 bad request

## How this service works

Tweets from X (Twitter) for one account or a search query. {"mode":"profile","query":"nasa"} returns that account's tweets, mode search takes keywords, and limit is 1-20. Each tweet has text, createdAt, url, lang, likeCount, retweetCount, replyCount, quoteCount, viewCount, isReply, isRetweet and an author object with userName, name, followers and isBlueVerified. No X developer account needed; pay per call in USDC.

## Output

Returns an array of up to 20 tweet objects, each containing: tweet text, creation timestamp, tweet URL, language code, like count, retweet count, reply count, quote count, view count, isReply and isRetweet flags, plus an author object with userName, display name, follower count, and blue-verified status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "search"
   ],
   "type": "string",
   "description": "profile=account's tweets, search=keyword→tweets"
  },
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "max results returned (clamped to this range)"
  },
  "query": {
   "type": "string",
   "description": "handle without @ (profile) or search keywords"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-twitter-x-scraper-f137e450/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agdata.shveik.dev](https://www.zero.xyz/host/agdata.shveik.dev/llms.txt)