# BlackBobs.ai Twitter API (v1/v2)

> BlackBobs.ai Twitter API (v1/v2) is a paid API for AI agents from blackbobs-ai.vercel.app, paid per call via x402, $0.141519/call, status unknown (last checked 2026-09-14).

Provides access to Twitter/X data and actions via a unified v1/v2 endpoint, including tweets, user profiles, and social data, billed per-call on Base chain via x402.

## Facts

- Endpoint: POST https://blackbobs-ai.vercel.app/api/twitter-v1-v2
- Price: $0.141519/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackbobs-ai-twitter-api-v1-v2-f408cf74
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_goS66lgL3tCQcTqrQ5sEA

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 blackbobs-ai-twitter-api-v1-v2-f408cf74 -d '<json body>'
```

Example prompt: Can you pull the most recent tweets from @elonmusk on Twitter and show me their engagement stats like likes and retweets?

## When to prefer this

Choose this endpoint when you need pay-per-call Twitter/X data access without managing your own Twitter API credentials or subscription. Ideal for agents that need occasional social data lookups billed directly in USDC on Base chain, especially when you want a unified interface that covers both Twitter API v1 and v2 endpoints without juggling separate auth flows.

## Known failure modes

- Invalid or missing Twitter query parameters returns an error in the result object
- Rate limits from the underlying Twitter API may cause failures or empty responses
- Deleted or suspended accounts return no data
- Tweets from private accounts are not accessible
- Malformed request body causes a 400-level error
- Insufficient USDC balance or x402 payment failure prevents the call from executing

## How this service works

194 production-ready API endpoints. AI, Search, Social, Finance, Crypto. Pay-per-call with x402 on Base chain.

## Output

Returns a JSON object with a 'result' field containing Twitter API response data — which may include tweet objects (text, author, timestamps, engagement counts), user profile objects (handle, bio, follower/following counts), or search result arrays depending on the query parameters provided.

## Request schema (JSON Schema)

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

## 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/blackbobs-ai-twitter-api-v1-v2-f408cf74/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blackbobs-ai.vercel.app](https://www.zero.xyz/host/blackbobs-ai.vercel.app/llms.txt)