# 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.118358/call, status unknown (last checked 2026-09-15).

Provides access to a suite of 18 paid Twitter/X API endpoints for reading, searching, and interacting with Twitter data via a unified POST interface

## Facts

- Endpoint: POST https://bb-twitter.vercel.app/api/twitter-v1-v2
- Price: $0.118358/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder-twitter-api-hub-e60c6884
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SD0Rp1V8ZIjeCOfCxSWXJ

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

Example prompt: Search Twitter for the latest tweets mentioning 'Base blockchain' from the past 7 days and return the top 10 results including author usernames, tweet text, and engagement counts.

## When to prefer this

Choose this endpoint when you need programmatic access to Twitter/X data (tweets, profiles, search) without managing your own Twitter API credentials, and are comfortable paying per-call in USDC via the x402 protocol. Best suited for agents that need ad-hoc Twitter lookups rather than sustained high-volume streaming.

## Known failure modes

- Invalid or missing endpoint selector returns an error indicating which sub-endpoint was intended
- Expired or rate-limited Twitter credentials on the backend return a 429 or 403 error
- Malformed query parameters return a 400 bad request
- Payment not settled via x402 protocol results in a 402 Payment Required response before data is returned
- Twitter user or tweet not found returns a 404-equivalent error in the response body

## How this service works

BaseBuilder Twitter API hub - 18 paid endpoints

## Output

Returns Twitter data such as tweets, user profiles, timelines, or search results depending on which of the 18 endpoint functions is invoked, structured as JSON with relevant Twitter metadata fields.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder-twitter-api-hub-e60c6884/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)