# agdata Twitter/X Fetcher

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

Fetches tweets from a specific Twitter/X account (profile mode) or runs a keyword search query on Twitter/X, returning structured tweet JSON including engagement metrics.

## Facts

- Endpoint: POST https://agdata.shveik.dev/mpp/twitter?utm_source=zero.xyz
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-twitter-x-fetcher-682adf9f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NEzJCUzdnAb-K4p5AjULp

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-fetcher-682adf9f -d '<json body>'
```

Example prompt: Pull the last 10 tweets from NASA's Twitter account in profile mode and show me their engagement numbers.

## When to prefer this

Choose this endpoint when you need structured tweet data including engagement metrics without a Twitter/X API key or developer account. It is ideal for agents doing social listening, brand monitoring, or content aggregation where the official API is too expensive or requires approval. Prefer it over generic web scrapers when you need parsed, schema-consistent tweet objects rather than raw HTML.

## Known failure modes

- Twitter rate limiting or anti-bot measures may cause fetch failures (not charged)
- Invalid or suspended Twitter username returns no results
- Search query returning zero matches returns empty array
- Limit exceeding maximum of 20 is rejected by schema validation
- Private or protected account tweets are inaccessible

## How this service works

Unblocking and fresh web data for AI agents. Social, maps, search, news, jobs and reviews as structured data, and unblocking for any other page, as Markdown or HTML. Pay per call in stablecoins over x402 or MPP, with no API key, no account and no proxy setup. (x402 on Base and Polygon (plus Solana on most routes) or MPP on Base)

## Output

Returns an array of tweet objects, each containing the tweet ID, URL, text content, language, author details, creation date, boolean flags for reply/retweet status, and engagement metrics including like count, view count, retweet count, reply count, quote count, and bookmark count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "profile",
    "search"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "21046956…",
  "url": "https://…",
  "lang": "en",
  "text": "On Monda…",
  "author": {},
  "isReply": false,
  "createdAt": "Mon Sep…",
  "isRetweet": false,
  "likeCount": 1210,
  "viewCount": 352841,
  "quoteCount": 11,
  "replyCount": 59,
  "retweetCount": 141,
  "bookmarkCount": 54
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-twitter-x-fetcher-682adf9f/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)