# AgentUtility Public Post Search (X/Twitter)

> AgentUtility Public Post Search (X/Twitter) is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Searches recent public posts on X/Twitter with public engagement metrics and author profile expansion, read-only, no account mutation.

## Facts

- Endpoint: POST https://x402.agentutility.ai/public-post-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-public-post-search-x-twitter-04927444
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J7o2EqHRwYv1SYUBLoQSf

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 agentutility-public-post-search-x-twitter-04927444 -d '<json body>'
```

Example prompt: Search X for recent public posts mentioning 'Base blockchain' from the last 7 days, and include engagement metrics and author info for each result.

## When to prefer this

Prefer this endpoint when an agent needs to search recent public X/Twitter posts by keyword, hashtag, or mention without needing to authenticate as a user or mutate any account state. It is ideal for social listening, brand monitoring, competitive intelligence, and trend tracking. Choose it over general web search when you specifically want structured social post data with author context and engagement metrics from X.

## Known failure modes

- No results found for obscure or very recent queries — returns empty list
- Rate limiting or quota exhaustion — returns 429 or equivalent error
- Invalid query syntax — returns 400 bad request
- X/Twitter API backend unavailability — returns 502 or 503
- Payment failure via x402 — call rejected before reaching the backend

## How this service works

Searches recent public posts on X/Twitter with public metrics and author expansion. Same read-only backend as x-search; useful for agents that ask for public post search rather than tweet search. No account mutation. Use it as a public post search API, social post search API, or X recent search endpoint.

## Output

Returns a list of recent public posts matching the search query, each including the post text, timestamp, author profile (name, handle, bio, follower count), and public engagement metrics (likes, retweets, replies, impressions where available).

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "query": {
       "type": "string",
       "description": "X recent-search query."
      },
      "max_results": {
       "type": "number",
       "description": "Number of recent posts to fetch. Clamped to 10-50. Default 10."
      },
      "language": {
       "type": "string",
       "description": "Optional two-letter language filter."
      }
     },
     "required": [
      "query"
     ]
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "mode": {
       "type": "string"
      },
      "result_count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "search",
  "source": "X API v2 recent search",
  "result_count": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-public-post-search-x-twitter-04927444/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)