GET
/v1/mentions/search
Agent-friendly search across X/Twitter mentions with full-text + filters. Returns enriched tweets with token name, spam/impostor flags.
AuthDeveloper tier+ API key
Request
GET
https://api.xrpl.to/v1/mentions/search| Query parameter | Value | Description |
|---|---|---|
| q | string (full-text search on tweet content, max 200 chars) | |
| author | string (username prefix match, case-insensitive) | |
| token | string (token name, ticker, or md5) | |
| from | ISO date or unix ms (lower bound on tweetCreatedAt) | |
| to | ISO date or unix ms (upper bound) | |
| minLikes | int | |
| minViews | int | |
| excludeSpam | bool (default true; pass false to include spam-flagged tweets) | |
| excludeImpostors | bool (filter out impostor accounts) | |
| sort | recent|engagement|views|relevance (relevance requires q) | |
| limit | int (max 100, default 20) | |
| offset | int (default 0) |
curl 'https://api.xrpl.to/v1/mentions/search' \ -H 'X-Api-Key: YOUR_KEY'
Needs Developer tier+ API key — copy the code and run it with your key.
Response
No public sample for this endpoint — run the code on the right with your own values and your key to see the response.
What it does
Agent-friendly search across X/Twitter mentions with full-text + filters. Returns enriched tweets with token name, spam/impostor flags.
Each token comes back with its md5, the id every Token endpoint takes. Go to Token →