# botsmith X Mentions

> botsmith X Mentions is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns the 20 latest tweets mentioning a given X (Twitter) handle, with engagement metrics, entities, top mentioning accounts, and a pagination cursor — no X account or API key required.

## Facts

- Endpoint: GET https://x402.botsmith.dev/x/mentions?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/botsmith-x-mentions-14c11d94
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GfO8TUVEvzxfi2nR1CODy

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 botsmith-x-mentions-14c11d94
```

Example prompt: Pull the latest 20 tweets mentioning @OpenAI on X and show me who's talking about them, their engagement numbers, and which accounts are mentioning them most.

## When to prefer this

Choose this endpoint when you need structured, metrics-rich mention data for any public X account without owning an X developer account or API key. It is ideal for brand monitoring, social listening, and agentic polling workflows where you pass sinceTime to retrieve only new mentions since the last check. Prefer it over building a custom X API integration when cost per call ($0.01) and instant JSON output are more important than bulk data or deep historical access.

## Known failure modes

- Invalid or non-existent X handle returns an error or empty tweet array
- Handle with no mentions returns an empty tweets array
- Invalid cursor string causes a pagination error
- sinceTime set in the future returns zero results
- Rate limiting or upstream X API unavailability causes a service error
- Payment of $0.01 USDC not confirmed causes a 402 response blocking the call

## How this service works

X Mentions ($0.01/call): Who is talking about an X (Twitter) account: the 20 latest posts that mention the handle, newest first, as clean JSON with metrics and entities, plus the accounts mentioning it most on the page and a cursor for older mentions. Optional sinceTime (unix seconds) to poll only what is new. No X account or API key needed.

## Output

Returns a JSON object containing: the queried handle, an array of up to 20 tweet objects (each with id, url, text, createdAt, lang, author info, engagement metrics, hashtags, expanded links, and mentioned accounts), a list of top mentioning authors on the current page, a boolean hasNextPage, and a nextCursor string for paginating to older mentions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "cursor": {
       "type": "string",
       "pattern": "^[A-Za-z0-9+/=_|-]{1,1000}$",
       "description": "Pagination cursor from a previous call"
      },
      "handle": {
       "type": "string",
       "pattern": "^@?[A-Za-z0-9_]{1,15}$",
       "description": "X handle, with or without the leading @"
      },
      "sinceTime": {
       "type": "integer",
       "maximum": 9007199254740991,
       "minimum": 0,
       "description": "Only mentions at or after this unix time (seconds)"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "handle",
      "tweets",
      "topAuthors",
      "hasNextPage",
      "nextCursor"
     ],
     "properties": {
      "handle": {
       "type": "string"
      },
      "tweets": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "id",
         "url",
         "text",
         "createdAt",
         "lang",
         "author",
         "metrics",
         "hashtags",
         "links",
         "mentions"
        ],
        "properties": {
         "id": {
          "type": "string"
         },
         "url": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "lang": {
          "anyOf": [
           {
            "type": "string"
           },
           {
            "type": "null"
           }
          ]
         },
         "text": {
          "type": "string"
         },
         "links": {
          "type": "array",
          "items": {
           "type": "string"
          },
          "description": "Expanded outbound URLs"
         },
         "author": {
          "type": "object",
          "required": [
           "handle",
  
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/botsmith-x-mentions-14c11d94/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)