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

# Tweet scraper & X API alternative

> Use Xquik as a tweet scraper and X API alternative. Search tweets, export followers and replies, retrieve profiles and timelines, and automate webhooks.

> For the complete documentation index, see [llms.txt](https://docs.xquik.com/llms.txt).

Use Xquik as a tweet scraper and X API alternative. Its X (Twitter) scraper API
searches tweets and can scrape follower lists and replies. It also retrieves
profiles and timelines. Post tweets, upload media, and monitor tweets every 1
second. Track profile changes, send signed webhooks, and connect SDKs or MCP.
Accountless guest wallets cover the prepaid GET reads. Direct MPP covers
fixed-price operations.

## Run in Postman

Fork the official Xquik collection into your Postman workspace. It holds every
request you can send with an API key. It groups them by tag, with example
responses.




[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/12709954-5ee4fae0-138a-4615-ae47-ac4be7904df2?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D12709954-5ee4fae0-138a-4615-ae47-ac4be7904df2%26entityType%3Dcollection%26workspaceId%3Db77ecb6f-d780-4179-968c-95dc06ae28c0)




Paste your API key into the collection's `apiKey` variable, then send any
request. Browse the
[public Postman workspace](https://www.postman.com/xquik-dev/xquik-apis)
or the
[hosted collection docs](https://documenter.getpostman.com/view/12709954/2sBY4TpxXK).
To import it into another tool, use the
[collection file](https://xquik.com/xquik.postman_collection.json).

## Copy-ready X tasks

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

### Search tweets

Returns `tweets`, `has_next_page`, and `next_cursor`. Omit `mode` for automatic
maximum coverage. Pass `next_cursor` back unchanged as `cursor`. Search supports
X operators such as `from:username`, `since:YYYY-MM-DD`, `until:YYYY-MM-DD`,
hashtags, phrases, and `OR`.
The cost is 1 credit per tweet returned.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
curl -G https://xquik.com/api/v1/x/tweets/search \
  --data-urlencode "q=from:username giveaway" \
  --data-urlencode "queryType=Latest" \
  --data-urlencode "limit=50" \
  -H "x-api-key: xq_your_api_key_here" | jq
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
{
  "tweets": [
    {
      "id": "1780000000000000000",
      "text": "Giveaway entry is open.",
      "createdAt": "2026-05-08T04:00:00Z",
      "likeCount": 42,
      "retweetCount": 5,
      "replyCount": 3,
      "author": {
        "id": "9876543210",
        "username": "username",
        "name": "Xquik"
      }
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}
```

### List followers

Returns `users`, `has_next_page`, and `next_cursor`. Omit `mode` for automatic
maximum coverage. Pass `next_cursor` back unchanged as `cursor`. Use `pageSize`
to cap each page between 20 and 10,000 users. The cost is 1 credit per follower returned.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
curl -G https://xquik.com/api/v1/x/users/username/followers \
  --data-urlencode "pageSize=50" \
  -H "x-api-key: xq_your_api_key_here" | jq
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
{
  "users": [
    {
      "id": "9876543210",
      "username": "username",
      "name": "Xquik",
      "followers": 10000,
      "following": 500,
      "verified": true
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}
```

### Upload media from a URL

Returns `mediaId` for tweet and DM `media_ids`, plus `mediaUrl` for tweet `media` arrays. URL uploads suit agents and workflow tools that pass files by HTTPS URL. The cost is 10 credits per upload.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
curl -X POST https://xquik.com/api/v1/x/media \
  -H "x-api-key: xq_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"account": "myxhandle", "url": "https://example.com/image.png"}' | jq
```

```json theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
{
  "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](https://docs.xquik.com/llms.txt) when an agent needs the right page. It covers the API, SDK, MCP, webhook, and billing pages.
* 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 Xquik code. It covers tweet search, follower exports, media uploads, DMs, monitors, and webhooks.
* Install the [X API alternative Skill](https://github.com/Xquik-dev/x-api) to move official X API code to Xquik.
* Connect API MCP at `https://xquik.com/mcp` for authenticated tasks. Use the [current client path](https://docs.xquik.com/mcp/overview.md#client-compatibility) for OAuth, API-key fallback, or an adapter. Full credentials expose every catalog route. Guest `paid_reads` keys expose the eligible paid-read routes.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/bash.json","/languages/csharp.json","/languages/go.json","/languages/java.json","/languages/javascript.json","/languages/kotlin.json","/languages/php.json","/languages/python.json","/languages/ruby.json","/languages/typescript.json"]}}
npx skills add Xquik-dev/x-twitter-scraper
npx skills add Xquik-dev/x-api
```

## What you can do

See [every Xquik feature](https://docs.xquik.com/api-reference/features.md) in 1 list, grouped by theme.

> [card] Tweets, followers & more
>
> Pull followers, following, replies, reposts, likes, and quotes. Also pull community members, list members, Space participants, tweet threads, profiles, posts, and media.

> [card] Giveaway draws
>
> Run random draws with archived tweet snapshots and public result pages.

> [card] Account monitoring
>
> Check monitored accounts every second. Deliver matched events through signed webhooks.

> [card] Developer API
>
> Use REST API v1, HMAC-signed webhooks, and an MCP server for AI agents.

> [card] Trending topics
>
> Read current X trends across 12 regions.

> [card] Radar
>
> Free trending topics and news from Xquik's own infrastructure. Filter by category, region, and time window.

> [card] Tweet composer
>
> Get source-backed writing guidance and one input check. It is free and needs no credits.

> [card] Style analysis & drafts
>
> Analyze tweet styles, compare accounts, track engagement performance, and save tweet drafts. Cache recent tweets for reference when composing.

> [card] X write API
>
> Act from your connected X accounts. Post tweets, like, retweet, follow, send DMs, upload media, and manage community membership.

> [card] Pay-per-use API
>
> Fund guest reads through a hosted checkout. Pay for fixed-price operations through direct MPP. You need no account.

## For developers

Xquik provides 6 integration methods.

**1. REST API v1**

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

**2. HMAC webhooks**

Receive monitor events at your HTTPS endpoint. Every delivery uses an HMAC-SHA256 signature.

**3. MCP server**

Connect AI agents through API MCP. Use OAuth 2.1 where supported. Otherwise, use the [documented client fallback](https://docs.xquik.com/mcp/overview.md#client-compatibility). Code Mode exposes `docs`, `search`, `execute`, and `whoami`. Add `?codemode=false` for OpenAPI-native tools.

**4. AI agent skill**

Add the [Xquik Skill](https://github.com/Xquik-dev/x-twitter-scraper) to a compatible agent. Claude Code, Cursor, Codex, Copilot and Windsurf all work. It covers the Xquik API, MCP tools, and REST operations. Run `npx skills add Xquik-dev/x-twitter-scraper`.

**5. Guest wallets**

Prepay the eligible paid-read routes without an account. Confirm USD 10 to 250 and create a hosted checkout through REST. Use the `paid_reads` key after Xquik verifies payment.

**6. Machine Payments Protocol**

Pay per API call without subscribing. MPP payments through Tempo (USDC) cover fixed-price read operations. See the [MPP overview](https://docs.xquik.com/mpp/machine-payments-protocol.md) for operations and pricing.

## Quick links

> [card] [Quickstart](https://docs.xquik.com/x-api-quickstart.md)
>
> Get your API key and make your first request in 5 minutes.

> [card] [API reference](https://docs.xquik.com/api-reference/overview.md)
>
> Read endpoint documentation with request and response schemas.

> [card] [MCP server](https://docs.xquik.com/mcp/overview.md)
>
> Use Code Mode or OpenAPI-native tools through API MCP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.