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 Xquik to search tweets, scrape follower lists, post tweets, upload media, monitor tweets every 1 second, send signed webhooks, and connect SDKs or MCP.

​
Copy-ready X tasks

Use these after you create an API key. Each call returns JSON you can send to an app, agent, spreadsheet job, webhook worker, or dashboard.

​
Search tweets

Returns tweets, has_next_page, and next_cursor. Search supports X operators such as from:username, #hashtag, quoted phrases, and OR. Cost: 1 credit per tweet returned. 
curl -G https://xquik.com/api/v1/x/tweets/search \
  --data-urlencode "q=from:xquikcom giveaway" \
  --data-urlencode "queryType=Latest" \
  --data-urlencode "limit=50" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

{
  "tweets": [
    {
      "id": "1780000000000000000",
      "text": "Giveaway entry is open.",
      "createdAt": "2026-05-08T04:00:00Z",
      "likeCount": 42,
      "retweetCount": 5,
      "replyCount": 3,
      "author": {
        "id": "9876543210",
        "username": "xquikcom",
        "name": "Xquik"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

​
List followers

Returns users, has_next_page, and next_cursor. Use pageSize to cap each page between 20 and 200 users. Cost: 1 credit per follower returned. 
curl -G https://xquik.com/api/v1/x/users/xquikcom/followers \
  --data-urlencode "pageSize=50" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

{
  "users": [
    {
      "id": "9876543210",
      "username": "xquikcom",
      "name": "Xquik",
      "followers": 10000,
      "following": 500,
      "verified": true
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}

​
Upload media from a URL

Returns mediaId for DMs and mediaUrl for tweet media arrays. URL uploads are useful for agents and workflow tools that pass files by HTTPS URL. Cost: 10 credits per upload. 
curl -X POST https://xquik.com/api/v1/x/media \
  -H "x-api-key: xq_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"account": "myxhandle", "url": "https://example.com/image.png"}' | jq

{
  "success": true,
  "mediaId": "1893726451023847424",
  "mediaUrl": "https://media.xquik.com/uploads/1893726451023847424.png"
}

​
Use Xquik with AI agents

Give agents a docs index first, then choose the execution path:
  • Use llms.txt when an agent needs to find the right API, SDK, MCP, webhook, or billing page.
  • Use the Context7 library when your coding environment supports Context7 docs lookup.
  • Install the Xquik Skill when the agent writes code for tweet search, follower exports, media uploads, DMs, monitors, or webhooks.
  • Connect https://xquik.com/mcp when the agent should run authenticated Xquik tasks from Claude, ChatGPT, Cursor, VS Code, or another MCP client.
npx skills add Xquik-dev/x-twitter-scraper

​
What you can do

23 Extraction Tools

Pull followers, replies, retweets, likes, community members, list data, and 16 more data types from any public account, tweet, list, community, or Space. See the full extraction catalog.

Giveaway Draws

Transparent, auditable random draws with archived tweet snapshots and public result pages.

Account Monitoring

Real-time tracking of tweets, quotes, replies, and retweets from monitored X accounts.

Developer API

REST API v1, HMAC-signed webhooks, and an MCP server for AI agent integration.

Trending Topics

Real-time trends across 12 regions worldwide.

Radar

Free trending topics and news from Xquik’s own infrastructure. Filter by category, region, and time window.

Tweet Composer

Compose, refine, and score tweet drafts against X ranking factors. Included with subscription, no usage cost.

Style Analysis & Drafts

Analyze tweet styles, compare accounts, track engagement performance, and save tweet drafts. Cache recent tweets for reference when composing.

X Write API

Post tweets, like, retweet, follow, send DMs, upload media, and manage community membership directly from your connected X accounts.

Pay-Per-Use API

Anonymous access to X data endpoints via the Machine Payments Protocol. Pay per call with Tempo (USDC), no account needed.

​
For developers

Xquik provides 5 integration methods:
1

REST API v1

Create monitors, query events, and manage webhooks programmatically. Authenticate with API keys via the x-api-key header.
2

HMAC Webhooks

Receive real-time event notifications at your HTTPS endpoints. Every delivery is signed with SHA-256 HMAC for verification.
3

MCP Server

Connect AI agents (Claude, ChatGPT, Cursor, VS Code, Windsurf) to Xquik via the Model Context Protocol. 2 tools (explore + xquik) at xquik.com/mcp using a code-execution sandbox model.
4

AI Agent Skill

Install the Xquik Skill to give 40+ AI coding agents (Claude Code, Cursor, Codex, Copilot, Windsurf, and more) deep knowledge of the Xquik API, MCP tools, and 120 REST operations. Install via npx skills add Xquik-dev/x-twitter-scraper.
5

Machine Payments Protocol

Pay per API call without subscribing. 31 X-API read-only endpoints accept MPP payments via Tempo (USDC). See the MPP overview for eligible endpoints and pricing.

Quickstart

Get your API key and make your first request in 5 minutes.

API Reference

Full endpoint documentation with request/response schemas.

MCP Server

Connect AI agents to Xquik.
Last modified on May 17, 2026