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.

Quick reference for terminology used throughout the Xquik platform and API.

​
Core concepts

A persistent watcher on an X user or keyword query that streams events via webhooks. Monitor slots are unlimited. Active instant monitors check every 1 second and cost 21 credits per hour.
A batch job that pulls historical data (tweets, followers, etc.) into exportable results. Extractions are metered operations - credit cost depends on the volume of data returned.
A giveaway selection tool that picks winners from extraction results. Draws support filters (minimum followers, account age) and produce a transparent, publicly verifiable result page.
A change detected by a monitor (new tweet, follower gained, profile update, etc.). Events are delivered to your server via webhooks in real time.

​
Billing & usage

The metered unit for API usage. Credit cost depends on the endpoint, returned result count, draw filters, media upload, or active monitor hours. Credits are included in your subscription and reset each billing period.
Operations that deduct credits from your balance. Includes reads, writes, and extractions. When credits are exhausted, metered calls return 402 Payment Required.
Operations that are free and do not consume credits. Includes reading and managing stored monitor records, stored event reads, webhooks, and account management endpoints. Active instant monitors are billed hourly while enabled.
Pay-as-you-go - purchase credits on demand via top-up at USD 0.00015/credit. Top-up credits are added to your balance immediately and do not expire.
Machine Payments Protocol - pay-per-call with USDC, no subscription required. Designed for autonomous agents that pay for each API call individually.

​
Delivery

An HTTP callback that delivers real-time monitor events to your server. Webhooks use HMAC-SHA256 signatures for payload verification. See the webhook guide for setup details.
An operation that modifies X state - tweet, like, follow, DM, etc. Write actions cost 10 credits and require a connected X account.

​
API & technical

Authentication credential passed via the x-api-key header. Generate keys from the dashboard or the API keys endpoint.
A pagination method using opaque cursor tokens instead of page numbers. Pass the cursor value from the previous response to fetch the next page. More reliable than offset-based pagination for real-time data.
The rate-limiting algorithm used by Xquik. Each user account gets a counter per tier. Read counters reset every 1 second; write and delete counters reset every 60 seconds. Requests are rejected with 429 when the counter exceeds the tier limit. See rate limits for details.
Last modified on May 8, 2026