# 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.014/call, status unknown (last checked 2026-10-14).

Fetch structured Twitter/X data by searching tweets or retrieving a user profile, paid per call via stablecoin microtransaction

## Facts

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

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-f9c57a0c -d '<json body>'
```

Example prompt: Search Twitter for the 10 most recent tweets about 'AI agents' and give me the text, like counts, and view counts for each one.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Twitter/X data (tweets, engagement metrics) without setting up a Twitter Developer account or managing OAuth tokens. It is especially useful for agents that need ad-hoc social data lookups, pay-per-use billing via stablecoins (USDC over x402/MPP), and support for both keyword search and profile-level tweet retrieval in a single endpoint with a consistent JSON schema.

## Known failure modes

- Query string exceeds 500 characters — request rejected
- Limit value outside 1–20 range — validation error
- Invalid mode value (not 'profile' or 'search') — schema rejection
- Payment insufficient or stablecoin transaction fails — 402 response
- Twitter/X rate limiting or blocking on backend — partial or empty result set
- User handle does not exist in profile mode — empty or error response
- Network timeout on agdata backend — HTTP 5xx

## 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, language code, full tweet text, author details object, boolean flags for reply and retweet status, ISO creation timestamp, and engagement counts including likes, views, retweets, quotes, replies, and bookmarks.

## 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-f9c57a0c/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)