Skip to main content
GET
/
events
/
{id}
Get event
curl --request GET \
  --url https://xquik.com/api/v1/events/{id} \
  --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.

Free - does not consume credits
curl https://xquik.com/api/v1/events/9001 \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  | jq '{
    event_id: .id,
    event_type: .type,
    monitor_type: .monitorType,
    monitor_id: .monitorId,
    keyword_monitor_id: (.keywordMonitorId // null),
    username: (.username // null),
    query: (.query // null),
    occurred_at: .occurredAt,
    x_event_id: (.xEventId // null),
    tweet_id: (.xEventId // .data.id // null),
    tweet_text: (.data.text // null),
    author_username: (.data.author.userName // null),
    event_detail_endpoint: ("/api/v1/events/" + .id),
    delivery_join_key: .id
  }'
The Node.js, Python, and Go examples convert one event into an audit row. Store event_id, monitor_type, monitor_id, event_type, occurred_at, x_event_id, tweet fields from data, event_detail_endpoint, and delivery_join_key; keyword monitor events use keyword_monitor_id and query instead of username.

​
Event detail handoff

Use this endpoint after list or delivery workflows find an event that needs full tweet data, author context, or support/audit review.

Detail Row

Store event_id, event_type, occurred_at, event_detail_endpoint, and delivery_join_key. Keep event_id as the Xquik event identifier.

Delivery Join

Match delivery_join_key to webhook delivery streamEventId from List Deliveries. Do not use x_event_id for delivery joins.

Monitor Source

Store monitor_type, monitor_id, keyword_monitor_id, username, and query so account and keyword monitor audits stay separate.

Tweet Payload

Store x_event_id, tweet_id, tweet_text, and author_username from data when the event contains tweet content.

Delivery Status

After joining deliveries, attach status, attempts, lastStatusCode, lastError, createdAt, and deliveredAt to the event detail row.

​
Path parameters

​
id
string
required
The event ID to retrieve.

​
Headers

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

​
Response

​
id
string
Unique event identifier.
​
type
string
Event type (e.g. tweet.new, tweet.reply, tweet.quote, tweet.retweet).
​
monitorId
string
Account monitor ID for account events, or keyword monitor ID for keyword events.
​
monitorType
string
Source type: account or keyword.
​
keywordMonitorId
string
Keyword monitor ID. Present only for keyword monitor events.
​
username
string
X username that triggered the event. Present only for account monitor events.
​
query
string
Keyword query that matched the event. Present only for keyword monitor events.
​
occurredAt
string
ISO 8601 timestamp of when the event occurred on X.
​
data
object
Raw tweet object from the X real-time stream. Fields vary by event type. See Webhooks Overview for event data shapes.
​
xEventId
string
X platform tweet ID associated with this event. Present only for tweet 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"
  },
  "xEventId": "1893456789012345678"
}
Related: List Events · List Deliveries · Get Monitor
Last modified on May 21, 2026