Skip to main content
curl -X POST https://xquik.com/api/v1/monitors \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "elonmusk",
    "eventTypes": ["tweet.new", "tweet.reply"]
  }' | jq

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
Content-Type
string
required
Must be application/json.

Body

username
string
required
X username to monitor. 1-15 characters, alphanumeric and underscores only. The @ prefix is automatically stripped if included.
eventTypes
string[]
required
Array of event types to subscribe to. At least 1 required. See Valid Event Types below.

Valid Event Types

Event TypeDescription
tweet.newNew original tweet posted
tweet.quoteQuote tweet posted
tweet.replyReply to another tweet
tweet.retweetRetweet of another tweet

Response

id
string
Unique monitor ID.
username
string
Normalized X username (lowercase, no @ prefix).
xUserId
string
Resolved X user ID for the account.
eventTypes
string[]
Event types this monitor is subscribed to.
createdAt
string
ISO 8601 timestamp of when the monitor was created.
{
  "id": "7",
  "username": "elonmusk",
  "xUserId": "44196397",
  "eventTypes": ["tweet.new", "tweet.reply"],
  "createdAt": "2026-02-24T10:30:00.000Z"
}
Next steps: List Monitors to see all your monitors, Get Monitor to fetch details, or Create Webhook to start receiving events at your endpoint.