# agdata Twitter Data API

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

Fetches Twitter/X profile data or search results as structured JSON, paid per call via stablecoin

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/x402/twitter?utm_source=zero.xyz
- Price: $0.0132/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-twitter-data-api-48e64484
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kF6BMZ07rYz_GkvwjBSs1

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-data-api-48e64484 -d '<json body>'
```

Example prompt: Search Twitter for the top 10 recent tweets about 'AI agents' and give me the text, author, like counts, and timestamps.

## When to prefer this

Choose this endpoint when you need structured Twitter/X data (tweets, engagement metrics, author info) without an official Twitter API key or account. It is ideal for AI agents that need to pay per call with no subscription, using stablecoins via x402 or MPP. Prefer this over scraping solutions when you need clean JSON output with engagement stats already parsed.

## Known failure modes

- Query string exceeds 500 characters — request rejected
- Limit outside 1–20 range — validation error
- Invalid mode value (not 'profile' or 'search') — error response
- Twitter/X rate limiting or blocking on the backend — may return empty or partial results
- Payment failure via x402/MPP — 402 Payment Required response
- Target profile is private or suspended — no results returned

## How this service works

Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.

## Output

A JSON object per tweet containing: tweet ID, URL, text, language, author object, creation timestamp, and engagement metrics (likes, views, quotes, replies, retweets, bookmarks). Up to 20 results per call depending on the limit parameter.

## 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-data-api-48e64484/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)