Skip to main content
GET https://xquik.com/api/v1/events
Free. This endpoint does not consume credits.
Account events include the current 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.
Stored monitor events expire 30 days after Xquik creates them. Export every page before older records expire. The dashboard has no CSV export for monitor events.
These examples emit one stored event row per line. Store 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

Use monitorId 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 the x-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. Pass nextCursor as the next cursor value.
Continue fetching pages until 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.

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 }