Complete results
- Searches return posts that X’s own search tab leaves out.
- Large date ranges come back whole & fast.
- Searches return every match, whatever operators you combine.
- Account searches include all of the account’s posts & reposts.
- Account history comes back complete, old posts included.
- Threads include every post & the author’s own replies.
- Profile exports keep every post of the author’s own threads.
- Profile reads include the pinned post, flagged as pinned.
- List timelines include posts that X’s List page leaves out.
- Follower & following exports return full lists.
- Verified follower exports return full lists too.
- Reply exports include replies that X’s post page leaves out.
- Reply exports work from any post ID or link.
- Complete mode adds replies the author hid & explains empty threads.
- Similar-account lists come back fuller.
- Top tweet lists come back reliably.
- Filtered pages come back full until the results run out.
- Every page size returns the same complete results.
- Timelines page all the way to the last post.
- Batch post lookups miss fewer posts.
- Account location labels fill in on more rows, at no extra charge.
- Each answer holds the fullest data X has for it.
Accurate rows
- Search results hold every post that matches your query & nothing else.
- Word & phrase matching works in every language & script.
- Language filters work for every language X tags.
- Language, date & engagement filters hold on every row you get.
- A post is called missing only when it’s gone.
- “X can’t run this search” appears only when it’s true.
- Protected accounts & private Lists get a clear answer, not an empty page.
- Reposts carry the full original text.
- Every ID in a row stays exact.
- Mentions, links, hashtags & highlights line up with the text.
- Counts X didn’t send are listed in
unknownCounts, never shown as 0. - Verified badges match what x.com shows.
- Rows hold public data only.
- Quote searches return every real quote & nothing else.
- Reply exports hold only direct replies, in a proven order.
- Reply pages count the replies a read hasn’t reached yet.
- Newest-first results come back in date order.
- Messy queries still run instead of failing.
- Place searches work with names in 6 languages.
- Searches X can’t run fail at once, with the fix.
- A date means one thing in any common form.
- Searches accept
since_id&max_idbounds. - Ads & promoted entries never reach your rows.
- Monitors report only real deletions, follows & unfollows.
- Profile change alerts don’t flap.
Fresh data
- Account monitors see changes within about a second.
- Keyword monitors catch every matching post.
- Monitors don’t miss posts between checks.
- A monitor that falls behind catches up on what it missed.
- Live videos & Spaces raise an event when they start.
- Post monitors report changes to likes, views & other counts.
- Trends can be read for any past moment since the archive began.
- Reads keep working when X ships changes.
Speed
- A slow X answer doesn’t hold up your request.
- Repeated lookups answer at once.
- Searches stay fast on busy topics.
- Each next page arrives fast.
- Actors read many handles, posts & queries at once.
- Reads finish the moment their rows arrive.
- Stalled Actor calls recover on their own.
- Webhooks arrive without connection setup delay.
Fair billing
- You pay only for the rows you get, after filters & duplicate removal.
- Every answer states its charge in
X-Xquik-Credits-Charged. - A retried page is free.
- A low balance trims results instead of failing.
- Bad input costs nothing, since it’s refused before any read.
- AI analysis bills only the posts it analyzed.
- Monitors have 1 flat hourly price, events & webhooks included.
- Monitor Actors bill only the hours a monitor watched.
- Writes cost nothing until they land.
- Saving the same media again is free.
- Removed media isn’t billed, & a single-post download with all its media removed returns
media_unavailable. - Empty trend history steps are free.
- You can price a bulk job before you run it.
- A post ID listed twice in a batch is billed once.
- Actors charge only for delivered, unique, matching rows.
- A profile shared by several targets is billed once.
- A restarted run never charges twice.
- A spend cap becomes a row cap, & diagnostics still get written.
- Tweet, reply & follower run reports estimate what the run cost.
- Small runs end with a tip that cuts cost.
- AI Actors don’t bill failed or skipped analyses.
- Each refund points at the exact charge it reverses.
Reliability
- A one-off X failure doesn’t fail your request.
- Paging stays consistent from one page to the next.
- Paging never loops forever.
- A deadline returns the rows already found, with diagnostics.
- Overload is announced with 503,
Retry-After& a reason. - Xquik answers 502 with
X-Xquik-Cause&Retry-Afterwhen X fails the read. - Actors ride out short Xquik outages.
- Actor runs survive restarts without repeats.
- One bad row doesn’t sink a batch.
- Stopped runs keep their rows & their report.
- A run that can’t start still explains itself.
stopCauses,failedSubtargets&unavailableTargetsspell out partial failures.- Bulk media downloads list each post they left out & why.
- Webhooks are signed & replay-safe.
- Webhook deliveries retry until they land, for up to 7 days.
- New events don’t queue behind old retries.
- Webhooks never go to private or local hosts.
- Missed events can be replayed from
Last-Event-ID. - Chat alerts arrive in order without hitting rate limits.
- A write reports success only once it’s live on X.
- Writes don’t post twice.
- Posting paces itself to protect your linked X accounts.
- Replies land on the right post.
- Retrying a write is safe with an idempotency key.
- A long write answers 202 with a status link, then lands on X.
- Problems on X’s side are fixed before they reach your reads.
- Asking again for a page in progress answers 409 with
Retry-After. - Support can see exactly what a request or run returned.
Built for agents
- Agents reach the whole API through a few MCP tools.
- Paid results are saved under a
result_id, so failed scripts never pay twice. - Large answers fit the agent’s context, capped at 24,000 characters.
- A cut answer links to a CSV file of every row.
- Each MCP tool states its credit price.
- Clients can run reads without prompts & confirm writes.
- 1 stable shape with snake_case, Unix seconds,
has_more&next_cursor. - Sign-in works in modern MCP clients with OAuth 2.1 & PKCE.
whoamireturns an account ID that never changes.- Agents can pay per call without an account.
- Tool input errors say what to change.
- MCP shows why a post or search failed.
- Pick only the fields you need with
fields&omit. - Actors accept input written for other Actors.
- Output is ready for spreadsheets, with flat columns & engagement totals.
- Scraper datasets describe every field.
- Every run says why it ended & whether to retry.
- Agents can find Xquik on their own through llms.txt & an agent card.
- Linked X accounts can post, like, repost, follow, bookmark, block, mute & send DMs.
- Give each agent an API key with only the scopes it needs.
- Every activity keeps a full record you can fetch & export.
- Rate limits & deprecations come as machine-readable headers.
- Common names for cursor, limit, sort & type just work.
- Pause a runaway agent’s API key in 1 click, then resume it anytime.
- Lock an API key to the IPs or CIDR ranges your servers call from.
- Cap what an API key spends each month, with an email at 80%.
- With an API key or OAuth, account timeline cursors fit in a URL.
Rich data
- Posts carry note text, edits, Community Notes, reach labels, reply controls & live events.
- Rows carry source apps, media counts & professional account data.
- Cashtag searches add X’s ticker card in
searchContext. - Media comes with variants, alt text, sizes & availability reasons.
- Video subtitles come with timed cues.
- You see when each account reposted a post.
- You see if each account replied to, reposted or quoted a post. You also see if it follows the author or is in a Community.
- Posts & bios can be translated into your language.
- Short links resolve, & list rows can carry full profiles.
- Profiles yield emails, phones & links tagged by network.
- Account location comes with country code, accuracy note & username history.
- Account checks say if each account is active, protected, suspended or missing.
- Trends by place name, country or region ID, promoted trends marked.
- Football games, plays, box scores, rosters, player props & game posts.
- Community Notes contributors & notes, Space replays & job listings as Markdown.
- AI answers carry probabilities, confidence & a question version.
- AI analysis reads each post’s images with its text, at no extra cost.
- Changes across analysis runs don’t flip on noise.
- Sentiment analysis names each post’s main emotion, such as joy or anger.
viralAlgorithmScoreturns a post’s public counts into 1 comparable number.- Each snapshot row holds every count’s change since an earlier run.
- Giveaway draws pick winners with cryptographic randomness.
- Shadowban checks show if X search lists an account, with each post they read.
Quality checks
- Every field X shows is served, left out on purpose or proven absent.
- Every read is checked live each hour.
- Actor READMEs, schemas & real output name the same fields.
- Xquik checks each API spec change against the docs before it ships.
Next steps
Search tweets
Run your first search & read the rows.
Monitors
Watch X accounts & get signed webhook events.
MCP server
Give your agent every read & write.
Billing
See the price per result & what costs nothing.