# x402.twit.sh - Twitter/X Mentions Lookup

> x402.twit.sh - Twitter/X Mentions Lookup is a paid API for AI agents from x402.twit.sh, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-15).

Retrieves real-time Twitter/X mention tweets for a specified user, returning tweet content, author info, and engagement metrics, paid per-request in USDC via x402 protocol.

## Facts

- Endpoint: GET https://x402.twit.sh/tweets/mentions
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-twit-sh-twitter-x-mentions-lookup-14e2196c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8Y2k6mUIIE-Hjc0vAvGgy

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 x402-twit-sh-twitter-x-mentions-lookup-14e2196c
```

Example prompt: Show me the latest tweets mentioning @halfin on Twitter — I want to see who's been tagging them and how much engagement those mentions are getting.

## When to prefer this

Choose this endpoint when you need real-time Twitter/X mention data without managing Twitter API credentials or OAuth flows. Ideal for AI agents that need pay-per-use access to mention streams without monthly subscription commitments. Best for monitoring social conversations, tracking engagement on specific accounts, or building mention-aware workflows using x402-compatible micropayment infrastructure.

## Known failure modes

- Invalid or non-existent username returns empty data array
- Expired or invalid pagination token causes pagination error
- Insufficient USDC balance or failed x402 payment returns 402 Payment Required
- Rate limiting by upstream Twitter/X API causes 429 or delayed response
- Private/suspended accounts may return no mentions data

## How this service works

Get the latest tweets that mention the authenticated user (the notifications timeline). Returns up to 20 tweets per page, most recent first, with pagination support. Query params: auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie; type (string, optional) - notifications timeline to read: All (default), Priority, or Mentions; next_token (string, optional) - pagination cursor. Returns X v2 API-compatible JSON.

## Output

Returns a paginated JSON array of mention tweets including tweet ID, text content, author details (id, name, username), creation timestamp, and public engagement metrics (likes, retweets, replies, quotes), plus a next_token for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "1110302988",
    "text": "Running bitcoin",
    "author": {
     "id": "9253672",
     "name": "Hal Finney",
     "username": "halfin"
    },
    "created_at": "2009-01-11T03:39:18.000Z",
    "public_metrics": {
     "like_count": 134000,
     "quote_count": 3500,
     "reply_count": 5400,
     "retweet_count": 32000
    }
   }
  ],
  "meta": {
   "next_token": "abc123"
  }
 }
}
```

## More

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