GET https://xquik.com/api/v1/events
Free. This endpoint does not consume credits.
username and permanent xUserId.
Use xUserId to match an account after its username changes.
monitorName is your monitor label when Xquik created the event.
A rename leaves past events unchanged.
MCP returns x_user_id, monitor_name, and prefixed monitor_id values.
Active monitor billing includes event and webhook deliveries.
event_id,
monitor_type, monitor_id, event_type, occurred_at, tweet fields from
data, event_detail_endpoint, delivery_join_key, and next_cursor. Pass
nextCursor as cursor until hasMore is false.
Source filter examples
UsemonitorId for account monitor events and keywordMonitorId for keyword
monitor events. Do not pass a keyword monitor ID as monitorId. That filter
matches account monitor events only.
Use postMonitorId for post monitor events. Post events carry postId,
postUrl & authorUsername.Query parameters
Headers
Response
200 OK
400 Invalid cursor
{ "error": "invalid_input", "message": "Cursor invalid. Use nextCursor from the previous page, or omit it to start over." }
The cursor value is not a nextCursor from this route. Send the last
nextCursor received, or omit cursor to start from the first page.401 Unauthenticated
Missing or invalid API key. Check thex-api-key header value.429 Rate limited
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 }
Too many requests. Wait for the Retry-After header before retrying.Event inventory handoff
This endpoint lists stored monitor events. Use it when an agent, dashboard, or support workflow needs that list. That caller uses it before looking up details or webhook delivery status.Event row
Store
event_id, event_type, occurred_at, and
event_detail_endpoint. Use Get Event when a
later step needs the full event payload.Monitor source
Store
monitor_type, monitor_id, keyword_monitor_id, username, and
query. That keeps account and keyword monitor events separate in exports.
Use monitorId for account-monitor filters and keywordMonitorId for
keyword-monitor filters.Tweet fields
Store
tweet_id, tweet_text, and author_username from data when the
event contains tweet content. Other event types can leave those fields
empty.Delivery join
Store
delivery_join_key as the event ID. In webhook delivery rows, match
it to streamEventId from
List Deliveries.Delivery status
Join deliveries first. Then store
status, attempts,
lastStatusCode, lastError, createdAt, and deliveredAt with the event
row.Cursor checkpoint
Store
next_cursor only when has_more is true. Pass it as cursor for
the next page and stop when has_more is false.Pagination
Events use cursor pagination. PassnextCursor as the next cursor value.hasMore is false. Cursors are opaque strings. Do not parse or build them.
An edited or unknown cursor returns 400 invalid_input. An empty cursor returns the first page.Related. Get Event · List Deliveries · List Monitors
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }