# Agent Wonderland Twitter/X Search API

> Agent Wonderland Twitter/X Search API is a paid API for AI agents from api.agentwonderland.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Searches Twitter/X for tweets by keyword query, retrieves tweets from a specific user's timeline, or fetches user profile information via a pay-per-call endpoint.

## Facts

- Endpoint: POST https://api.agentwonderland.com/x402/endpoints/twitterx-search
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-wonderland-twitter-x-search-api-054aacc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fu8dTkcPQ69cC3Y1Sg1xt

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 agent-wonderland-twitter-x-search-api-054aacc1 -d '<json body>'
```

Example prompt: Search Twitter/X for up to 20 recent tweets about 'AI agents from:elonmusk' and show me the results.

## When to prefer this

Choose this endpoint when you need to programmatically search Twitter/X tweets by keyword, retrieve a user's recent timeline, or fetch user profile data within an agent workflow — especially when operating in an x402 pay-per-call context and needing up to 25 results per call without managing Twitter API credentials directly.

## Known failure modes

- Invalid mode value (not 'search', 'user_tweets', or 'user_info') returns an error
- Query or username missing when required for the selected mode
- max_results exceeds 25 or is less than 1, triggering a validation error
- Twitter/X API rate limits or downtime causing failed lookups
- Payment failure via x402 protocol resulting in a 402 response
- Username not found on Twitter/X returning empty or error result

## How this service works

Agent Wonderland is a pay-per-call marketplace for agent-ready API endpoints, MCP tools, and x402 services.

## Output

Returns a JSON object with a job_id, agent_id, status field ('success' or error), and an output object containing the tweet search results or user timeline/info depending on the mode selected.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "type": "string",
   "title": "Mode",
   "default": "search",
   "description": "Mode: search, user_tweets, or user_info"
  },
  "query": {
   "type": "string",
   "title": "Query",
   "default": "",
   "description": "Search query for tweets",
   "json_schema_extra": {
    "example": "AI agents from:elonmusk"
   }
  },
  "username": {
   "type": "string",
   "title": "Username",
   "default": "",
   "description": "Get tweets from this user's timeline",
   "json_schema_extra": {
    "example": "elonmusk"
   }
  },
  "max_results": {
   "type": "integer",
   "title": "Max Results",
   "default": 20,
   "maximum": 25,
   "minimum": 1,
   "description": "Maximum tweets to return (max 25)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "job_id": "job_123",
  "output": {
   "result": "Agent run completed"
  },
  "status": "success",
  "agent_id": "aba10c88-21a1-4353-882d-c760aa6ab5fe"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-wonderland-twitter-x-search-api-054aacc1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentwonderland.com](https://www.zero.xyz/host/api.agentwonderland.com/llms.txt)