# Twitter/X User Timeline Fetcher

> Twitter/X User Timeline Fetcher is a paid API for AI agents from kite-hub-v3.vercel.app, paid per call via x402, $0.14/call, status unknown (last checked 2026-10-12).

Fetches the recent tweet timeline for a specified Twitter/X user account

## Facts

- Endpoint: POST https://kite-hub-v3.vercel.app/api/twitter-v1-timeline?utm_source=zero.xyz
- Price: $0.14/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-user-timeline-fetcher-583100e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SAyb4XTa69v0lkD5IdPQD

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 twitter-x-user-timeline-fetcher-583100e9 -d '<json body>'
```

Example prompt: Can you pull the last 20 tweets from Elon Musk's Twitter timeline so I can see what he's been posting recently?

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-request access to a Twitter user's public timeline without maintaining your own Twitter API credentials or developer account. Ideal for agents doing one-off or low-frequency social monitoring tasks where a monthly API subscription would be wasteful. Best suited when you want to fetch tweets for analysis, monitoring, or content research and can pay $0.14 USDC per call on Base chain.

## Known failure modes

- User account not found or suspended — API returns error in result object
- Rate limiting from underlying Twitter API — may return quota exceeded error
- Private/protected account — timeline not accessible without follow approval
- Invalid username format — request rejected before reaching Twitter
- Network timeout on the KiteEndpoints proxy — returns no data
- Insufficient USDC balance — x402 payment fails and request is not processed

## How this service works

400+ paid API endpoints. Social media, AI, crypto, finance, weather, ecommerce, tools. Pay per request with USDC on Base chain.

## Output

Returns a structured object containing the user's recent tweets, including tweet text, timestamps, retweet/like counts, and associated user metadata. The response is wrapped in a result object with a data field containing the timeline array from the Twitter API.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "result": {
   "data": "example response"
  }
 },
 "properties": {
  "result": {
   "type": "object",
   "description": "API response data"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-user-timeline-fetcher-583100e9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kite-hub-v3.vercel.app](https://www.zero.xyz/host/kite-hub-v3.vercel.app/llms.txt)