Skip to main content
GET
/
events
List events
curl --request GET \
  --url https://xquik.com/api/v1/events \
  --header 'x-api-key: <x-api-key>'
Free — does not consume credits
curl "https://xquik.com/api/v1/events?limit=10&monitorId=7" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

​
Query parameters

​
limit
number
Results per page. Default 50, max 100.
​
monitorId
string
Filter events by monitor ID. Omit to return events from all monitors.
​
eventType
string
Filter by event type: tweet.new, tweet.reply, tweet.quote, tweet.retweet, follower.gained, follower.lost. Omit to return all types.
​
after
string
Cursor for pagination. Pass the nextCursor value from a previous response to fetch the next page.

​
Headers

​
x-api-key
string
required
Your API key.

​
Response

​
events
array
List of event objects matching the query.
​
hasMore
boolean
true if additional pages exist beyond this result set.
​
nextCursor
string
Pagination cursor. Pass as the after query parameter to fetch the next page. Present only when hasMore is true.
{
  "events": [
    {
      "id": "9001",
      "type": "tweet.new",
      "monitorId": "7",
      "username": "elonmusk",
      "occurredAt": "2026-02-24T14:22:00.000Z",
      "data": {
        "id": "1893456789012345678",
        "text": "The future is now.",
        "author": {
          "id": "44196397",
          "userName": "elonmusk",
          "name": "Elon Musk"
        },
        "isRetweet": false,
        "isReply": false,
        "isQuote": false,
        "createdAt": "2026-02-24T14:22:00.000Z"
      }
    },
    {
      "id": "9002",
      "type": "tweet.reply",
      "monitorId": "7",
      "username": "elonmusk",
      "occurredAt": "2026-02-24T15:05:30.000Z",
      "data": {
        "id": "1893456789012345999",
        "text": "Absolutely. Shipping next week.",
        "author": {
          "id": "44196397",
          "userName": "elonmusk",
          "name": "Elon Musk"
        },
        "isRetweet": false,
        "isReply": true,
        "isQuote": false,
        "inReplyToId": "1893456789012345900",
        "createdAt": "2026-02-24T15:05:30.000Z"
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "MjAyNi0wMi0yNFQxNTowNTozMC4wMDBafDkwMDI="
}

​
Pagination

Events use cursor-based pagination. Each response includes hasMore and (when true) a nextCursor value. Pass nextCursor as the after query parameter to retrieve the next page. 
curl "https://xquik.com/api/v1/events?limit=10&monitorId=7" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
Continue fetching pages until hasMore is false. Cursors are opaque strings. Do not parse or construct them manually.
Related: Get Event · List Monitors