Skip to main content

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.

Use this X API quickstart to create an API key, call GET /account, monitor tweets every 1 second with POST /monitors, and send signed webhook events with POST /webhooks. You can reuse the same calls from REST, SDKs, MCP, or automation tools.

First API Call

Call GET /account to confirm authentication, subscription status, credit balance, and monitor billing.

First Monitor

Create an account monitor that checks every 1 second. Active monitors cost 21 credits per hour while enabled.

First Webhook

Register an HTTPS endpoint and save the one-time secret for HMAC signature verification.
1

Create an account

Sign up at xquik.com with your email. You’ll receive a magic link, no password required.
2

Subscribe

An active subscription is required to use the Xquik API. All metered endpoints return 402 without a subscription. See Pricing, credits & billing for plan details.
Xquik requires an active subscription to access the API. Starter is USD 20/month and includes 140,000 monthly credits. Subscribe from the dashboard billing page.
3

Generate an API key

Open API Keys in the dashboard and create a new key. Copy the full key immediately - it’s only shown once.
xq_YOUR_KEY_HERE
Store your API key securely. It cannot be retrieved after creation. Revoke and replace if compromised.
4

Make your first request

Verify your setup by fetching your account info:
curl -s https://xquik.com/api/v1/account \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
Response:
{
  "plan": "active",
  "monitorsAllowed": 9007199254740991,
  "monitorsUsed": 0,
  "monitorBilling": {
    "activeDailyEstimate": "0",
    "activeHourlyBurn": "0",
    "creditsPerActiveMonitorDay": "500",
    "creditsPerActiveMonitorHour": "21",
    "eventsIncluded": true,
    "instantCheckIntervalSeconds": 1,
    "unlimitedSlots": true
  },
  "creditInfo": {
    "balance": "50000",
    "lifetimePurchased": "140000",
    "lifetimeUsed": "90000",
    "autoTopupEnabled": false,
    "autoTopupAmountDollars": 10,
    "autoTopupThreshold": "50000"
  }
}
5

Create a monitor

Start tracking an X account:
curl -s -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
Response:
{
  "id": "7",
  "username": "elonmusk",
  "xUserId": "44196397",
  "eventTypes": ["tweet.new", "tweet.reply"],
  "isActive": true,
  "createdAt": "2026-02-24T10:30:00.000Z",
  "nextBillingAt": "2026-02-24T10:30:00.000Z"
}
6

Set up a webhook (optional)

Receive events in real time at your endpoint:
curl -s -X POST https://xquik.com/api/v1/webhooks \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "eventTypes": ["tweet.new"]}' | jq
Response:
{
  "id": "15",
  "url": "https://your-server.com/webhook",
  "eventTypes": ["tweet.new"],
  "secret": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "createdAt": "2026-02-24T10:30:00.000Z"
}
Save the secret from the response in a secret manager. It is only returned once, and you need it to verify webhook signatures. Do not print it in shared logs.

​
Next steps

API Reference

Full endpoint documentation.

Extract Data

Pull followers, replies, and more from X.

Run a Draw

Execute a giveaway draw on a tweet.

Webhook Verification

Verify HMAC signatures on incoming webhooks.

MCP Server

Connect AI agents to Xquik.

Error Handling

Handle errors, rate limits, and retries.

Billing & Usage

Track usage, manage your subscription, and view quotas.

​
Troubleshooting

Verify the header name is x-api-key (lowercase). Check that the key starts with xq_ and hasn’t been revoked. Regenerate from the API Keys dashboard.
Creating extractions, draws, active monitors, media downloads, and X lookups requires an active subscription and enough credits. Webhook operations are free. Reading, updating, deleting, exporting, and testing existing extractions, draws, monitors, and stored events is also free. Active instant monitors cost 21 credits per hour while enabled. Other free endpoints include compose, styles, drafts, radar, account, API keys, credit balance, and credit top-ups. Check your account status via Get Account.
Verify the URL uses HTTPS. Check that the webhook is active via List Webhooks. Test delivery with the Test Webhook endpoint.
The API uses a 3-tier fixed window: 60 reads/1s, 30 writes/60s, 15 deletes/60s. Implement exponential backoff and respect the Retry-After header. See Rate Limits.
Last modified on May 23, 2026