1 credit per result returned · All plans from $0.00012/credit Requires a connected X account. Uses user-authenticated access.
curl -G https://xquik.com/api/v1/x/notifications \
--data-urlencode "type=Mentions" \
-H "x-api-key: xq_YOUR_KEY_HERE" | jq
# Page 2
curl -G https://xquik.com/api/v1/x/notifications \
--data-urlencode "type=Mentions" \
--data-urlencode "cursor=abc123" \
-H "x-api-key: xq_YOUR_KEY_HERE" | jq
Query parameters
Notification filter. All (default), Verified, or Mentions.
Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.
Your API key. Session cookie authentication is also supported.
Response
Array of notification objects.
Notification type (e.g. mention, like, retweet). Omitted if unavailable.
Notification message text. Omitted if unavailable.
ISO 8601 timestamp. Omitted if unavailable.
Whether more notifications are available.
Opaque cursor for the next page. Empty string when no more results.
{
"notifications": [
{
"id": "1893456789012345678",
"type": "mention",
"message": "@xquikcom Great tool!",
"timestamp": "2026-02-24T10:00:00.000Z"
}
],
"has_next_page": true,
"next_cursor": "DAADDAABCgABF..."
}
{ "error": "unauthenticated" }
{ "error": "no_subscription" }
{ "error": "x_api_unavailable" }
