Search Alerts API: keyword matches across X
Programmatic access to Search Alerts — keyword search alerts. For bot commands & pricing, see the Search Alerts Telegram guide.
Auth: Bearer token with sa_ prefix, generated via the API Key button in the Search Alerts management screen.
Authorization: Bearer sa_your_api_key_here| Method | Path | Description |
|---|---|---|
| GET | /v1/sa/queries | List search queries |
| POST | /v1/sa/queries | Add query. Body: {"query_text": "solana airdrop"} |
| DELETE | /v1/sa/queries/{id} | Remove query |
| GET | /v1/sa/webhook | Get saved webhook URL |
| PUT | /v1/sa/webhook | Save a webhook URL. Delivery: WebSocket today; webhook delivery coming soon |
| GET | /v1/sa/status | Subscription status, query count, max queries |
Match Event
{
"type": "search_alert",
"data": {
"query_id": 1,
"query_text": "solana airdrop",
"tweet_id": "1234567890",
"full_text": "Massive Solana airdrop incoming...",
"screen_name": "CryptoWhale",
"display_name": "Crypto Whale",
"tweet_url": "https://x.com/CryptoWhale/status/1234567890"
}
}WebSocket
wss://api.xanguard.tech/v1/sa/ws?api_key=sa_your_keyReceives JSON events when new tweets match your keyword queries. Each query is checked across all of X at the interval you choose (1 min to 6 h), so matches are not real-time. Webhook delivery for Search Alerts is coming soon.