# BlackBobs.ai Twitter v2 API

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

Provides access to Twitter/X v2 API data and actions via a pay-per-call proxy endpoint on Base chain

## Facts

- Endpoint: POST https://blackbobs-ai.vercel.app/api/twitter-v2
- Price: $0.168718/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-v2-api-c0dde6cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_63VSZSWXQY8vZ1poXhYd3

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-v2-api-c0dde6cd -d '<json body>'
```

Example prompt: Search Twitter for the latest tweets mentioning 'Bitcoin ETF' from the past 24 hours and give me the top 5 most engaging ones.

## When to prefer this

Choose this endpoint when you need real-time or recent Twitter/X data without managing your own Twitter API credentials, and you want pay-per-call pricing via crypto (USDC on Base) rather than a monthly subscription. Ideal for agents that occasionally need Twitter lookups without committing to Twitter API rate-limit tiers.

## Known failure modes

- Invalid or malformed Twitter query parameters return an error result
- Rate limiting from the underlying Twitter v2 API may cause failures or throttled responses
- Payment failure on Base chain (insufficient USDC) prevents the call from executing
- Non-existent tweet IDs or suspended user handles return empty or error results
- Restricted or protected account data may be inaccessible

## 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 result object containing Twitter v2 API response data, which may include tweet objects (id, text, created_at, metrics), user profile data (name, username, follower count), or search result collections depending on the query submitted.

## 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-v2-api-c0dde6cd/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)