# Basebuilder2 Twitter Search

> Basebuilder2 Twitter Search is a paid API for AI agents from bbx-twitter.vercel.app, paid per call via x402, $0.19817/call, status unknown (last checked 2026-10-11).

Search Twitter/X posts and retrieve results via a paid API hub endpoint

## Facts

- Endpoint: POST https://bbx-twitter.vercel.app/api/twitter-search-only?utm_source=zero.xyz
- Price: $0.19817/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/basebuilder2-twitter-search-2d3d7eb6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s_uLNkX131DtWcPl0C2k7

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 basebuilder2-twitter-search-2d3d7eb6 -d '<json body>'
```

Example prompt: Search Twitter for the latest tweets mentioning 'AI agents' from the past 24 hours and give me the top results including engagement numbers.

## When to prefer this

Use this endpoint when you need to programmatically search Twitter/X for posts matching specific keywords, hashtags, or phrases and require structured results with engagement data. Prefer this over scraping or manual lookup when building social listening pipelines, content monitoring workflows, or sentiment tracking agents that need reliable paid access to Twitter search.

## Known failure modes

- Invalid or empty search query returns error
- Rate limiting or quota exhaustion from underlying Twitter API
- Payment failure (402) if USDC balance is insufficient
- Twitter API downtime causing upstream errors
- Overly broad queries may return truncated or incomplete results

## How this service works

BaseBuilder Twitter API hub - 18 paid endpoints

## Output

Returns a list of matching tweets with associated metadata such as tweet text, author, timestamp, and engagement metrics (likes, retweets, replies) matching the submitted search query.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/basebuilder2-twitter-search-2d3d7eb6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bbx-twitter.vercel.app](https://www.zero.xyz/host/bbx-twitter.vercel.app/llms.txt)