Skip to main content
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.
1

Create an account

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

Subscribe

Xquik requires an active subscription ($20/month) to access the API. Subscribe from the dashboard billing page. Your plan includes 1 monitor and a monthly usage quota.
3

Generate an API key

Navigate to API Keys in the dashboard sidebar 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": 1,
  "monitorsUsed": 0,
  "currentPeriod": {
    "start": "2026-02-01T00:00:00.000Z",
    "end": "2026-03-01T00:00:00.000Z",
    "usagePercent": 0
  }
}
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"],
  "createdAt": "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. It is only returned once. You’ll need it to verify webhook signatures.

​
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 dashboard.
Metered endpoints (extractions, draws, media download) require an active subscription. Check your account status via Get Account. Free endpoints (compose, styles) work without a subscription.
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: 120 reads/60s, 30 writes/60s, 15 deletes/60s. Implement exponential backoff and respect the Retry-After header. See Rate Limits.