# 402box X/Twitter Search Agent

> 402box X/Twitter Search Agent is a paid API for AI agents from agents.402box.io, paid per call via x402, $0.05/call, status down (last checked 2026-09-15).

Searches X/Twitter in real-time to retrieve trends, news, and social media insights using an AI-powered agent

## Facts

- Endpoint: POST https://agents.402box.io/x_searcher
- Price: $0.05/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-402box-io-90802594
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LjPk38A1YGE1JeQvIcehU

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 agents-402box-io-90802594 -d '<json body>'
```

Example prompt: Search X/Twitter right now and tell me what people are saying about the Bitcoin ETF — I want the latest trends, notable posts, and any breaking news from the past few hours.

## When to prefer this

Use this endpoint when you need real-time social media intelligence from X/Twitter — trending topics, breaking news, public sentiment, or viral content — rather than static web search. It's particularly suited for time-sensitive queries where recency matters and X/Twitter is the primary signal source. Prefer this over general web search when the goal is specifically to understand social media conversations, influencer activity, or Twitter-native trends.

## Known failure modes

- Query returns no results if topic is too obscure or niche
- Agent may time out if too many iterations are needed for complex queries
- LLM or compute cost may vary depending on query complexity
- success: false returned if the agent fails to complete execution
- Rate limiting or payment failure may prevent the request from completing

## How this service works

AI-powered X/Twitter search agent - Get real-time trends, news, and social media insights

## Output

A markdown-formatted response containing X/Twitter search results, trending topics, news, and social media insights relevant to the query, along with detailed usage metrics including token counts, tool calls, execution time, and cost breakdown in USDC.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "message"
 ],
 "properties": {
  "message": {
   "type": "string",
   "description": "Search query or prompt for the X/Twitter searcher agent"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "usage": {
     "type": "object",
     "properties": {
      "cost": {
       "type": "object",
       "properties": {
        "llm_usdc": {
         "type": "number",
         "description": "LLM cost in USDC"
        },
        "total_usdc": {
         "type": "number",
         "description": "Total cost in USDC"
        },
        "compute_usdc": {
         "type": "number",
         "description": "Compute cost in USDC"
        }
       },
       "description": "Cost breakdown in USDC"
      },
      "iterations": {
       "type": "number",
       "description": "Number of agent iterations"
      },
      "tool_calls": {
       "type": "number",
       "description": "Number of tool calls made"
      },
      "tokens_input": {
       "type": "number",
       "description": "Number of input tokens used"
      },
      "tokens_output": {
       "type": "number",
       "description": "Number of output tokens generated"
      },
      "execution_time_ms": {
       "type": "number",
       "description": "Total execution time in milliseconds"
      }
     },
     "description": "Detailed usage metrics for the invocation"
    },
    "agent_id": {
     "type": "string",
     "description": "ID of the agent that processed the request"
    },
    "response": {
     "type": "string",
     "description": "Formatted markdown response with X/Twitter search results and trends"
    },
    "agent_name": {
     "type": "string",
     "description": "Human-readable name of the agent"
    },
    "invocation_id": {
     "type": "string",
     "description": "Unique identifier for this invocation"
    },
    "execution_mode": {
     "enum": [
      "serverless",
      "persistent"
     ],
     "type": "string",
     "description": "Execution mode (serverless or persistent)"
    }
   },
   "description": "Agent invocation response"
  },
  "success": {
   "type": "boolean",
   "description": "Whether the request was successful"
  },
  "timestamp": {
   "type": "string",
   "description": "ISO 8601 timestamp of the response"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-402box-io-90802594/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.402box.io](https://www.zero.xyz/host/agents.402box.io/llms.txt)