List webhook events & replay monitor activity

{
  "events": [],
  "hasMore": false
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

GET

events

List webhook events & replay monitor activity

curl --request GET \
  --url https://xquik.com/api/v1/events \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "events": [
    {
      "id": "<string>",
      "type": "<string>",
      "monitorId": "<string>",
      "monitorType": "<string>",
      "keywordMonitorId": "<string>",
      "username": "<string>",
      "query": "<string>",
      "occurredAt": "<string>",
      "data": {}
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

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 remain available for 90 days. Export every page before older records expire. The dashboard has no CSV export for monitor events.

curl "https://xquik.com/api/v1/events?limit=10&monitorId=7" \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '. as $page | .events[] | {
    event_id: .id,
    event_type: .type,
    monitor_type: .monitorType,
    monitor_id: .monitorId,
    monitor_name: (.monitorName // null),
    x_user_id: (.xUserId // null),
    keyword_monitor_id: (.keywordMonitorId // null),
    username: (.username // null),
    query: (.query // null),
    occurred_at: .occurredAt,
    tweet_id: (.data.id // null),
    tweet_text: (.data.text // null),
    author_username: (.data.author.username // .data.author.userName // null),
    event_detail_endpoint: ("/api/v1/events/" + .id),
    delivery_join_key: .id,
    has_more: $page.hasMore,
    next_cursor: ($page.nextCursor // null)
  }'

const response = await fetch("https://xquik.com/api/v1/events?limit=10&monitorId=7", {
  headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
});
const data = await response.json();
const eventRows = data.events.map((event) => ({
  event_id: event.id,
  event_type: event.type,
  monitor_type: event.monitorType,
  monitor_id: event.monitorId,
  monitor_name: event.monitorName ?? null,
  x_user_id: event.xUserId ?? null,
  keyword_monitor_id: event.keywordMonitorId ?? null,
  username: event.username ?? null,
  query: event.query ?? null,
  occurred_at: event.occurredAt,
  tweet_id: event.data?.id ?? null,
  tweet_text: event.data?.text ?? null,
  author_username: event.data?.author?.username ?? event.data?.author?.userName ?? null,
  event_detail_endpoint: `/api/v1/events/${event.id}`,
  delivery_join_key: event.id,
  has_more: data.hasMore,
  next_cursor: data.nextCursor ?? null,
}));

for (const row of eventRows) {
  process.stdout.write(`${JSON.stringify(row)}\n`);
}

import json
import requests

response = requests.get(
    "https://xquik.com/api/v1/events",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    params={"limit": 10, "monitorId": "7"},
)
data = response.json()
event_rows = []
for event in data["events"]:
    tweet = event.get("data") if isinstance(event.get("data"), dict) else {}
    author = tweet.get("author") if isinstance(tweet.get("author"), dict) else {}
    event_rows.append(
        {
            "event_id": event["id"],
            "event_type": event["type"],
            "monitor_type": event["monitorType"],
            "monitor_id": event["monitorId"],
    "monitor_name": event.get("monitorName"),
    "x_user_id": event.get("xUserId"),
            "keyword_monitor_id": event.get("keywordMonitorId"),
            "username": event.get("username"),
            "query": event.get("query"),
            "occurred_at": event["occurredAt"],
            "tweet_id": tweet.get("id"),
            "tweet_text": tweet.get("text"),
            "author_username": author.get("username") or author.get("userName"),
            "event_detail_endpoint": f"/api/v1/events/{event['id']}",
            "delivery_join_key": event["id"],
            "has_more": data["hasMore"],
            "next_cursor": data.get("nextCursor"),
        }
    )
for row in event_rows:
    print(json.dumps(row))

package main

import (
  "encoding/json"
  "log"
  "net/http"
  "os"
)

type EventAuthor struct {
  Username *string `json:"username"`
}

type EventPayload struct {
  ID     *string      `json:"id"`
  Text   *string      `json:"text"`
  Author *EventAuthor `json:"author"`
}

type Event struct {
  ID               string       `json:"id"`
  Type             string       `json:"type"`
  MonitorType      string       `json:"monitorType"`
  MonitorID        string       `json:"monitorId"`
  MonitorName      *string      `json:"monitorName"`
  XUserID          *string      `json:"xUserId"`
  KeywordMonitorID *string      `json:"keywordMonitorId"`
  Username         *string      `json:"username"`
  Query            *string      `json:"query"`
  OccurredAt       string       `json:"occurredAt"`
  Data             EventPayload `json:"data"`
}

type EventResponse struct {
  Events     []Event `json:"events"`
  HasMore    bool    `json:"hasMore"`
  NextCursor *string `json:"nextCursor"`
}

type EventRow struct {
  DeliveryJoinKey      string  `json:"delivery_join_key"`
  EventDetailEndpoint  string  `json:"event_detail_endpoint"`
  EventID              string  `json:"event_id"`
  EventType            string  `json:"event_type"`
  MonitorType          string  `json:"monitor_type"`
  MonitorID            string  `json:"monitor_id"`
  MonitorName          *string `json:"monitor_name"`
  XUserID              *string `json:"x_user_id"`
  KeywordMonitorID     *string `json:"keyword_monitor_id"`
  Username             *string `json:"username"`
  Query                *string `json:"query"`
  OccurredAt           string  `json:"occurred_at"`
  TweetID              *string `json:"tweet_id"`
  TweetText            *string `json:"tweet_text"`
  AuthorUsername       *string `json:"author_username"`
  HasMore              bool    `json:"has_more"`
  NextCursor           *string `json:"next_cursor"`
}

func main() {
  req, err := http.NewRequest("GET", "https://xquik.com/api/v1/events?limit=10&monitorId=7", nil)
  if err != nil {
    log.Fatal(err)
  }
  req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")

  resp, err := http.DefaultClient.Do(req)
  if err != nil {
    log.Fatal(err)
  }
  defer resp.Body.Close()

  var data EventResponse
  if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
    log.Fatal(err)
  }

  encoder := json.NewEncoder(os.Stdout)
  for _, event := range data.Events {
    var authorUsername *string
    if event.Data.Author != nil {
      authorUsername = event.Data.Author.Username
    }

    row := EventRow{
      DeliveryJoinKey:     event.ID,
      EventDetailEndpoint: "/api/v1/events/" + event.ID,
      EventID:             event.ID,
      EventType:           event.Type,
      MonitorType:         event.MonitorType,
      MonitorID:           event.MonitorID,
    MonitorName:         event.MonitorName,
    XUserID:             event.XUserID,
      KeywordMonitorID:    event.KeywordMonitorID,
      Username:            event.Username,
      Query:               event.Query,
      OccurredAt:          event.OccurredAt,
      TweetID:             event.Data.ID,
      TweetText:           event.Data.Text,
      AuthorUsername:      authorUsername,
      HasMore:             data.HasMore,
      NextCursor:          data.NextCursor,
    }
    if err := encoder.Encode(row); err != nil {
      log.Fatal(err)
    }
  }
}

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.

curl "https://xquik.com/api/v1/events?limit=50&monitorId=7" \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '{events: [.events[] | {id, type, monitorId, username}], hasMore, nextCursor}'

curl "https://xquik.com/api/v1/events?limit=50&keywordMonitorId=21" \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '{events: [.events[] | {id, type, keywordMonitorId, query}], hasMore, nextCursor}'

Query parameters

number

Results per page. Default 50, max 100.

string

Filter account-monitor events by account monitor ID. Use keywordMonitorId for keyword-monitor events. Omit both filters to return events from all monitors.

string

Filter keyword-monitor events by keyword monitor ID. Use the id returned by keyword monitor endpoints.

string

Filter by event type. Valid types: tweet.new, tweet.quote, tweet.reply, tweet.retweet, tweet.media, tweet.link, tweet.poll, tweet.mention, tweet.hashtag, tweet.longform, profile.avatar.changed, profile.banner.changed, profile.name.changed, profile.username.changed, profile.bio.changed, profile.location.changed, profile.url.changed, profile.verified.changed, profile.protected.changed, profile.pinned_tweet.changed, profile.unavailable.changed. Omit to return all types.

string

Cursor for pagination. Pass the nextCursor value from a previous response to fetch the next page. An edited or unknown cursor returns 400.

Headers

string

required

Your API key.

Response

200 OK

array

List of event objects matching the query. Event object fields.

string

Unique event identifier.

string

Event type from the monitor event type list.

string

Account monitor ID for account events, or keyword monitor ID for keyword events.

string

Source type: account or keyword.

string

Keyword monitor ID. Present only for keyword monitor events.

string

X username that triggered the event. Present only for account monitor events.

string

Keyword query that matched the event. Present only for keyword monitor events.

string

ISO 8601 timestamp of when the event occurred on X.

object

Post or profile-change data. Post fields match REST responses.

Post profiles use username and verified. Legacy fields remain available. See Webhooks Overview for each event type.

boolean

true if more pages exist beyond this result set.

string

Pagination cursor. Pass it as cursor for the next page.

{
  "events": [
    {
      "id": "9001",
      "type": "tweet.new",
      "monitorId": "7",
      "monitorType": "account",
      "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",
      "monitorType": "account",
      "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="
}

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 you received, or omit cursor to start from the first page.

401 Unauthenticated

{ "error": "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

Use this endpoint when an agent, dashboard, or support workflow needs a list of stored monitor events before looking up details or webhook delivery status.

Event inventory column	Response source	Pagination rule
Event ID	`events[].id`	Open one event or join a webhook delivery.
Event type	`events[].type`	Route tweet, reply, quote, or repost records.
Monitor source	`events[].monitorType`	Separate account and keyword monitor rows.
Account source	`events[].monitorId` and `username`	Filter one tracked X account.
Keyword source	`events[].keywordMonitorId` and `query`	Filter one tracked X search.
Tweet fields	`events[].data`	Export tweet text, author, and timestamps.
More pages	`hasMore`	Continue only while this value is `true`.
Next page	`nextCursor`	Pass this value as the next `cursor` parameter.

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 so account and keyword monitor events stay 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

After joining deliveries, 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.

curl "https://xquik.com/api/v1/events?limit=10&monitorId=7" \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '{event_ids: [.events[].id], has_more: .hasMore, next_cursor: (.nextCursor // null)}'

curl "https://xquik.com/api/v1/events?limit=10&monitorId=7&cursor=MjAyNi0wMi0yNFQxNTowNTozMC4wMDBafDkwMDI=" \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '{event_ids: [.events[].id], has_more: .hasMore, next_cursor: (.nextCursor // null)}'

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.

Related. Get Event · List Deliveries · List Monitors

{
  "events": [],
  "hasMore": false
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

List webhook events & replay monitor activity

curl --request GET \
  --url https://xquik.com/api/v1/events \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://xquik.com/api/v1/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/events"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "events": [
    {
      "id": "<string>",
      "type": "<string>",
      "monitorId": "<string>",
      "monitorType": "<string>",
      "keywordMonitorId": "<string>",
      "username": "<string>",
      "query": "<string>",
      "occurredAt": "<string>",
      "data": {}
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

List webhook events & replay monitor activity

Source filter examples

Query parameters

Headers

Response

200 OK

400 Invalid cursor

401 Unauthenticated

429 Rate limited

Event inventory handoff

Event row

Monitor source

Tweet fields

Delivery join

Delivery status

Cursor checkpoint

​Source filter examples

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid cursor

​401 Unauthenticated

​429 Rate limited

​Event inventory handoff

Event row

Monitor source

Tweet fields

Delivery join

Delivery status

Cursor checkpoint

​Pagination

Source filter examples

Query parameters

Headers

Response

200 OK

400 Invalid cursor

401 Unauthenticated

429 Rate limited

Event inventory handoff

Pagination