# AgentBodega X Post Search

> AgentBodega X Post Search is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.06/call, status unknown (last checked 2026-09-14).

Searches X (Twitter) posts using advanced filters like keywords, hashtags, author, engagement thresholds, and boolean operators.

## Facts

- Endpoint: POST https://agentbodega.store/api/social-media/x/tweet-search
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentbodega-x-post-search-b4002a3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_plh8gmZEm-v8CjV-8kpSC

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 agentbodega-x-post-search-b4002a3a -d '<json body>'
```

Example prompt: Search X for posts from OpenAI mentioning 'agents' that have at least 10 likes and show me the top 5 results.

## When to prefer this

Choose this endpoint when an agent needs to search X (Twitter) posts with granular filters — combining keyword, phrase, boolean, hashtag, author, recipient, and engagement threshold logic in a single call. It is ideal for social listening, brand monitoring, and content research tasks where structured filtering beyond basic keyword search is needed, and when the agent operates in an x402-payable micropayment context.

## Known failure modes

- No results found if query filters are too restrictive (e.g. very high minLikes threshold)
- Invalid or unsupported query syntax may return an error or empty results
- Rate limits or payment failures may block the request
- Posts from private or suspended accounts are not returned
- Very recent posts may not yet be indexed

## How this service works

Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.

## Output

Returns a JSON object containing a list of matching X posts, each with the post ID, normalized text, author username, and engagement metrics (likes, replies, reposts), along with the total result count and the original query parameters used.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "query",
       "type": "string",
       "required": false
      },
      {
       "name": "words",
       "type": "string",
       "required": false
      },
      {
       "name": "phrase",
       "type": "string",
       "required": false
      },
      {
       "name": "anyWords",
       "type": "array",
       "required": false
      },
      {
       "name": "noneWords",
       "type": "array",
       "required": false
      },
      {
       "name": "hashtags",
       "type": "array",
       "required": false
      },
      {
       "name": "from",
       "type": "string",
       "required": false
      },
      {
       "name": "to",
       "type": "string",
       "required": false
      },
      {
       "name": "mentioning",
       "type": "string",
       "required": false
      },
      {
       "name": "minReplies",
       "type": "integer",
       "required": false
      },
      {
       "name": "minLikes",
       "type": "integer",
       "required": false
      },
      {
       "name": "minReposts",
       "type": "integer",
       "required": false
      }
     ],
     "required": [],
     "fieldCount": 15,
     "contentType": "application/json",
     "optionalPreview": [
      "query",
      "words",
      "phrase",
      "anyWords",
      "noneWords",
      "hashtags",
      "from",
      "to",
      "mentioning",
      "minReplies",
      "minLikes",
      "minReposts"
     ],
     "omittedFieldCount": 3
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": {
   "id": "x-tweet-search",
   "name": "X Post Search",
   "department": "Social Media"
  },
  "results": [
   {
    "id": "1110302988",
    "text": "Normalized public post text",
    "author": {
     "username": "OpenAI"
    },
    "metrics": {
     "likes": 10,
     "replies": 1,
     "reposts": 2
    }
   }
  ],
  "success": true,
  "requested": {
   "query": "agent from:OpenAI min_faves:10",
   "maxResults": 5
  },
  "result_count": 5
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentbodega-x-post-search-b4002a3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)