> ## 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.

# Xquik: Real-Time X Data Platform & API

> Search tweets, scrape followers, post tweets, upload media, monitor tweets, and send webhooks with Xquik REST API, SDKs, and MCP.

<blockquote className="agent-llms-directive">
  For the complete documentation index, see <a href="/llms.txt">llms.txt</a>.
</blockquote>

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`, `since:YYYY-MM-DD`, `until:YYYY-MM-DD`, `#hashtag`, quoted phrases, and `OR`. Cost: 1 credit per tweet returned.

```bash theme={null}
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
```

```json theme={null}
{
  "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.

```bash theme={null}
curl -G https://xquik.com/api/v1/x/users/xquikcom/followers \
  --data-urlencode "pageSize=50" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq
```

```json theme={null}
{
  "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.

```bash theme={null}
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
```

```json theme={null}
{
  "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](/llms.txt) when an agent needs to find the right API, SDK, MCP, webhook, or billing page.
* Use the [Context7 library](https://context7.com/xquik-dev/xquik-docs) when your coding environment supports Context7 docs lookup.
* Install the [Xquik Skill](https://github.com/Xquik-dev/x-twitter-scraper) 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.

```bash theme={null}
npx skills add Xquik-dev/x-twitter-scraper
```

## What you can do

<CardGroup cols={2}>
  <Card title="23 Extraction Tools" icon="pickaxe">
    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](/api-reference/overview#extractions).
  </Card>

  <Card title="Giveaway Draws" icon="trophy">
    Transparent, auditable random draws with archived tweet snapshots and public result pages.
  </Card>

  <Card title="Account Monitoring" icon="radio">
    Real-time tracking of tweets, quotes, replies, and retweets from monitored X accounts.
  </Card>

  <Card title="Developer API" icon="code">
    REST API v1, HMAC-signed webhooks, and an MCP server for AI agent integration.
  </Card>

  <Card title="Trending Topics" icon="trending-up">
    Real-time trends across 12 regions worldwide.
  </Card>

  <Card title="Radar" icon="radar">
    Free trending topics and news from Xquik's own infrastructure. Filter by category, region, and time window.
  </Card>

  <Card title="Tweet Composer" icon="pen-line">
    Compose, refine, and score tweet drafts against X ranking factors. Included with subscription, no usage cost.
  </Card>

  <Card title="Style Analysis & Drafts" icon="sparkles">
    Analyze tweet styles, compare accounts, track engagement performance, and save tweet drafts. Cache recent tweets for reference when composing.
  </Card>

  <Card title="X Write API" icon="send">
    Post tweets, like, retweet, follow, send DMs, upload media, and manage community membership directly from your connected X accounts.
  </Card>

  <Card title="Pay-Per-Use API" icon="credit-card">
    Anonymous access to X data endpoints via the Machine Payments Protocol. Pay per call with Tempo (USDC), no account needed.
  </Card>
</CardGroup>

## For developers

Xquik provides 5 integration methods:

<Steps>
  <Step title="REST API v1">
    Create monitors, query events, and manage webhooks programmatically. Authenticate with API keys via the `x-api-key` header.
  </Step>

  <Step title="HMAC Webhooks">
    Receive real-time event notifications at your HTTPS endpoints. Every delivery is signed with SHA-256 HMAC for verification.
  </Step>

  <Step title="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.
  </Step>

  <Step title="AI Agent Skill">
    Install the [Xquik Skill](https://github.com/Xquik-dev/x-twitter-scraper) 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`.
  </Step>

  <Step title="Machine Payments Protocol">
    Pay per API call without subscribing. 32 X-API read-only endpoints accept MPP payments via Tempo (USDC). See the [MPP overview](/mpp/overview) for eligible endpoints and pricing.
  </Step>
</Steps>

## Quick links

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get your API key and make your first request in 5 minutes.
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference/overview">
    Full endpoint documentation with request/response schemas.
  </Card>

  <Card title="MCP Server" icon="bot" href="/mcp/overview">
    Connect AI agents to Xquik.
  </Card>
</CardGroup>