# AIsa Payment Gateway - Twitter User Mentions Lookup

> AIsa Payment Gateway - Twitter User Mentions Lookup is a paid API for AI agents from pay.lnpay.ai, paid per call via x402, $0.03/call, status unknown (last checked 2026-09-13).

Fetches paginated tweet mentions (20 per page) for a given Twitter/X user screen name, ordered by mention time descending

## Facts

- Endpoint: GET https://pay.lnpay.ai/twitter/user/mentions
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aisa-payment-gateway-twitter-user-mentions-lookup-196a2434
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DAnTJEK9djncTynGqv0oW

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 aisa-payment-gateway-twitter-user-mentions-lookup-196a2434
```

Example prompt: Can you pull the latest mentions for the Twitter user @elonmusk — start from the first page and show me anything from the last 7 days?

## When to prefer this

Use this endpoint when you need to retrieve tweet mentions for a specific Twitter/X user in reverse chronological order, especially when you need pagination support or time-range filtering. Prefer over scraping or other social monitoring tools when you need structured, paginated mention data with cursor-based navigation via a pay-per-call micropayment model.

## Known failure modes

- Invalid or non-existent screen name returns empty results or 404
- Missing required userName parameter returns a 400 validation error
- Invalid cursor value may return unexpected page or error
- Payment not fulfilled (402) if x402 payment header is missing or insufficient
- sinceTime or untilTime out of valid range may return no results
- Rate limiting from underlying Twitter API may cause 429 errors

## How this service works

Get tweet mentions by user screen name. Each page returns exactly 20 mentions. Use cursor for pagination. Order by mention time desc

## Output

Returns a paginated list of up to 20 tweet objects that mention the specified user, ordered by most recent mention first, along with a cursor value to fetch the next page of results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "userName"
 ],
 "properties": {
  "cursor": {
   "type": "string",
   "description": "The cursor to paginate through the results. First page is \"\"."
  },
  "userName": {
   "type": "string",
   "description": "The user screen name to get. eg. kaitoEasyApi"
  },
  "sinceTime": {
   "type": "integer",
   "description": "On or after a specified unix timestamp in seconds."
  },
  "untilTime": {
   "type": "integer",
   "description": "Before a specified unix timestamp in seconds."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-payment-gateway-twitter-user-mentions-lookup-196a2434/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pay.lnpay.ai](https://www.zero.xyz/host/pay.lnpay.ai/llms.txt)