Skip to main content
GET
/
x
/
notifications
Get notifications
curl --request GET \
  --url https://xquik.com/api/v1/x/notifications \
  --header 'x-api-key: <api-key>'

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page or ID list, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
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

​
type
string
Notification filter. All (default), Verified, or Mentions. Unrecognized values fall back to All.
​
cursor
string
Pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.

​
Headers

​
x-api-key
string
required
Your API key. Session cookie authentication is also supported.

​
Response

​
notifications
object[]
Array of notification objects.
​
has_next_page
boolean
Whether more notifications are available.
​
next_cursor
string
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..."
}
Related: Timeline · DM History
Last modified on May 9, 2026