Get Started with Xquik API

Use this account quickstart to create a full API key, call GET /account, monitor tweets every 1 second with POST /monitors, and send signed webhook events with POST /webhooks. For accountless reads, use a guest wallet across 33 routes or direct MPP across 7 operations.

First API Call

Call GET /account to confirm authentication, plan status, available credits, 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

Accountless Reads

Prepay 33 eligible GET routes with a

10-

250 USD Stripe-hosted Payment Link. No account required.

Create an account

Fund your account

Metered account operations require enough available credits. An active plan is not required while sufficient credits remain.

Subscribe for monthly credits or use your remaining account balance. Starter is USD 20/month and includes 140,000 monthly credits. Manage funding from the dashboard billing page. Guest wallets cover 33 prepaid GET routes without an account. Direct MPP covers 7 fixed-price operations.

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_api_key_here

Store your API key securely. It cannot be retrieved after creation. Revoke and replace if compromised.

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_api_key_here" | jq

const response = await fetch("https://xquik.com/api/v1/account", {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const account = await response.json();
process.stdout.write(`${JSON.stringify(account, null, 2)}\n`);

import requests

response = requests.get(
    "https://xquik.com/api/v1/account",
    headers={"x-api-key": "xq_your_api_key_here"},
)
print(response.json())

package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://xquik.com/api/v1/account", nil)
    req.Header.Set("x-api-key", "xq_your_api_key_here")

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

    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

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"
  }
}

Create a monitor

Start tracking an X account:

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

const response = await fetch("https://xquik.com/api/v1/monitors", {
  method: "POST",
  headers: {
    "x-api-key": "xq_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    username: "elonmusk",
    eventTypes: ["tweet.new", "tweet.reply"],
  }),
});
const monitor = await response.json();
process.stdout.write(`${JSON.stringify(monitor, null, 2)}\n`);

import requests

response = requests.post(
    "https://xquik.com/api/v1/monitors",
    headers={"x-api-key": "xq_your_api_key_here"},
    json={
        "username": "elonmusk",
        "eventTypes": ["tweet.new", "tweet.reply"],
    },
)
print(response.json())

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "username":   "elonmusk",
        "eventTypes": []string{"tweet.new", "tweet.reply"},
    })

    req, _ := http.NewRequest("POST", "https://xquik.com/api/v1/monitors", bytes.NewReader(body))
    req.Header.Set("x-api-key", "xq_your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

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

    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println(string(respBody))
}

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"
}

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_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-server.com/webhook", "eventTypes": ["tweet.new"]}' | jq

const response = await fetch("https://xquik.com/api/v1/webhooks", {
  method: "POST",
  headers: {
    "x-api-key": "xq_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    url: "https://your-server.com/webhook",
    eventTypes: ["tweet.new"],
  }),
});
const webhook = await response.json();
const webhookSecret = webhook.secret;
if (!webhookSecret) throw new Error("missing webhook secret");
process.stdout.write(`Webhook ${webhook.id} ready\n`);
// Store webhookSecret in your secret manager; do not print it.

import requests

response = requests.post(
    "https://xquik.com/api/v1/webhooks",
    headers={"x-api-key": "xq_your_api_key_here"},
    json={
        "url": "https://your-server.com/webhook",
        "eventTypes": ["tweet.new"],
    },
)
webhook = response.json()
webhook_secret = webhook["secret"]
if not webhook_secret:
    raise RuntimeError("missing webhook secret")
print(f"Webhook {webhook['id']} ready")
# Store webhook_secret in your secret manager; do not print it.

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    body, _ := json.Marshal(map[string]interface{}{
        "url":        "https://your-server.com/webhook",
        "eventTypes": []string{"tweet.new"},
    })

    req, _ := http.NewRequest("POST", "https://xquik.com/api/v1/webhooks", bytes.NewReader(body))
    req.Header.Set("x-api-key", "xq_your_api_key_here")
    req.Header.Set("Content-Type", "application/json")

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

    var webhook struct {
        ID     string `json:"id"`
        Secret string `json:"secret"`
    }
    if err := json.NewDecoder(resp.Body).Decode(&webhook); err != nil {
        panic(err)
    }

    webhookSecret := webhook.Secret
    if webhookSecret == "" {
        panic("missing webhook secret")
    }
    fmt.Printf("Webhook %s ready\n", webhook.ID)
    // Store webhookSecret in your secret manager; do not print it.
}

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 API MCP v2.5.4 through Streamable HTTP. Use explore, then xquik.

Error Handling

Handle errors, rate limits, and retries.

Billing & Usage

Track usage, manage your subscription, and view quotas.

Troubleshooting

Magic link email not received

Keep using your Xquik account email. Wait 60 seconds, request a new link, then open the newest email within 15 minutes. Check your spam or junk folder. If no email arrives, contact support@xquik.com with the exact request time.

API key not working (401)

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.

Getting 401 or 402

Neither status creates checkout. Anonymous non-MPP paid reads return 401 with a Bearer challenge and guest wallet action. The 7 direct MPP reads return 402 with a Payment challenge and the same action. Account and guest credit failures return 402 with credential-specific choices. Ask the user to choose and confirm before creating checkout. See Billing.

Webhook not receiving events

Verify the URL uses HTTPS. Check that the webhook is active via List Webhooks. Test delivery with the Test Webhook endpoint.

Rate limited (429)

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.

Getting Started

SDKs

Guides

Webhooks

MCP Server

Agent Plugins

Framework Guides

OAuth

MPP

Resources

Get Started with Xquik API

First API Call

First Monitor

First Webhook

Accountless Reads

Next steps

API Reference

Extract Data

Run a Draw

Webhook Verification

MCP Server

Error Handling

Billing & Usage

Troubleshooting

First API Call

First Monitor

First Webhook

Accountless Reads

​Next steps

API Reference

Extract Data

Run a Draw

Webhook Verification

MCP Server

Error Handling

Billing & Usage

​Troubleshooting

Next steps

Troubleshooting