# BaseBuilder Twitter API Hub

> BaseBuilder Twitter API Hub is a paid API for AI agents from bb-twitter.vercel.app, paid per call via x402, $0.11257/call, status unknown (last checked 2026-10-12).

Provides access to 18 paid Twitter/X API endpoints for reading, searching, and interacting with Twitter data via x402 micropayments

## Facts

- Endpoint: POST https://bb-twitter.vercel.app/api/twitter-x-api?utm_source=zero.xyz
- Price: $0.11257/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder-twitter-api-hub-ed6b691b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xzgIQg3TZwMbKq4L_uB8Q

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 basebuilder-twitter-api-hub-ed6b691b -d '<json body>'
```

Example prompt: Search Twitter for the latest tweets mentioning 'Base blockchain' from the past 24 hours and pull back the top 10 results with engagement stats.

## When to prefer this

Choose this endpoint when you need programmatic access to Twitter/X data with pay-per-call micropayment pricing via x402 and do not want to manage Twitter API credentials or subscriptions directly. It is well-suited for agents that make sporadic or variable-volume Twitter queries and want to pay only for what they use in USDC.

## Known failure modes

- Invalid or suspended Twitter username returns 404 or empty result
- Rate limits from the underlying Twitter API cause 429 errors
- Insufficient x402 payment or incorrect USDC amount causes 402 rejection
- Malformed POST body with missing required parameters returns 400 validation error
- Private/protected account data is inaccessible and returns permission error

## How this service works

BaseBuilder Twitter API hub - 18 paid endpoints

## Output

Returns structured Twitter data including tweets, user profiles, engagement metrics (likes, retweets, replies), timestamps, and metadata depending on which of the 18 endpoint actions is invoked via POST body parameters.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder-twitter-api-hub-ed6b691b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bb-twitter.vercel.app](https://www.zero.xyz/host/bb-twitter.vercel.app/llms.txt)