Xquik - X (Twitter) Data Platform

Xquik provides a REST API, MCP server, and HMAC webhooks for X (Twitter) data. It covers tweet search, user profiles, bulk extraction (19 tools), giveaway draws, account monitoring, and trending topics.

Docs: docs.xquik.com

Quick Reference

https://xquik.com/api/v1

x-api-key: xq_...

https://xquik.com/mcp

Prerequisites

• Xquik account with active subscription
• API key generated from the Xquik dashboard
• For MCP: configure the endpoint in your client (Claude Desktop, Claude Code, Cursor, VS Code, etc.)

Setup

MCP Server (Claude Code)

Add to your MCP configuration:

{
  "mcpServers": {
    "xquik": {
      "type": "streamable-http",
      "url": "https://xquik.com/mcp",
      "headers": {
        "x-api-key": "xq_YOUR_KEY_HERE"
      }
    }
  }
}

REST API

const API_KEY = "xq_YOUR_KEY_HERE";
const BASE = "https://xquik.com/api/v1";
const headers = { "x-api-key": API_KEY, "Content-Type": "application/json" };

Core Workflows

1. Search Tweets

When to use: Find tweets by keyword, hashtag, or user.

Endpoint:

GET /x/tweets/search?q=...

MCP tool:

search-tweets

const results = await fetch(`${BASE}/x/tweets/search?q=from:elonmusk AI`, { headers });

Pitfalls:

• Basic results only (id, text, author, date). Use

  lookup-tweet

  for engagement metrics
• Searches recent tweets, not full archive

2. Look Up a Tweet

When to use: Get full metrics (likes, retweets, views, bookmarks) for a specific tweet.

Endpoint:

GET /x/tweets/{id}

MCP tool:

lookup-tweet

3. Look Up a User Profile

When to use: Get name, bio, follower/following counts, profile picture, join date.

Endpoint:

GET /x/users/{username}

MCP tool:

get-user-info

Pitfalls:

• MCP returns a subset (no verified, location, createdAt, statusesCount). Use REST API for the full profile

4. Check Follow Relationship

When to use: Check if account A follows account B (both directions).

Endpoint:

GET /x/followers/check?source=A&target=B

MCP tool:

check-follow

5. Bulk Data Extraction (19 Tools)

When to use: Extract followers, replies, retweets, quotes, community members, list data, and more.

Workflow: Always estimate cost first, then create the job, then retrieve results.

Tool types:

reply_extractor

repost_extractor

quote_extractor

thread_extractor

article_extractor

follower_explorer

following_explorer

verified_follower_explorer

mention_extractor

post_extractor

community_extractor

community_moderator_explorer

community_post_extractor

community_search

list_member_extractor

list_post_extractor

list_follower_explorer

space_explorer

people_search

MCP tools:

estimate-extraction

run-extraction

get-extraction

// 1. Estimate cost
const estimate = await fetch(`${BASE}/extractions/estimate`, {
  method: "POST", headers,
  body: JSON.stringify({ toolType: "follower_explorer", targetUsername: "elonmusk" }),
}).then(r => r.json());

if (!estimate.allowed) return; // Would exceed monthly quota

// 2. Create job
const job = await fetch(`${BASE}/extractions`, {
  method: "POST", headers,
  body: JSON.stringify({ toolType: "follower_explorer", targetUsername: "elonmusk" }),
}).then(r => r.json());

// 3. Retrieve results (paginated)
const results = await fetch(`${BASE}/extractions/${job.id}`, { headers }).then(r => r.json());

Pitfalls:

• Always call estimate first.

  402

  means quota exhausted
• Large jobs return

  status: "running"

  and need polling
• Export (CSV/XLSX/MD) capped at 50,000 rows

6. Giveaway Draws

When to use: Pick random winners from tweet replies with configurable filters.

Endpoint:

POST /draws

MCP tool:

run-draw

Available filters:

mustRetweet

mustFollowUsername

filterMinFollowers

filterAccountAgeDays

filterLanguage

requiredKeywords

requiredHashtags

requiredMentions

uniqueAuthorsOnly

const draw = await fetch(`${BASE}/draws`, {
  method: "POST", headers,
  body: JSON.stringify({
    tweetUrl: "https://x.com/user/status/123456789",
    winnerCount: 3,
    uniqueAuthorsOnly: true,
    mustRetweet: true,
  }),
}).then(r => r.json());

7. Real-Time Monitoring

When to use: Track when an account tweets, gets replies, gains/loses followers.

Workflow: Create a monitor, optionally register a webhook for push notifications.

Event types:

tweet.new

tweet.reply

tweet.quote

tweet.retweet

follower.gained

follower.lost

MCP tools:

add-monitor

add-webhook

test-webhook

// Create monitor
await fetch(`${BASE}/monitors`, {
  method: "POST", headers,
  body: JSON.stringify({
    username: "elonmusk",
    eventTypes: ["tweet.new", "follower.gained"],
  }),
});

// Register webhook (save the secret!)
const webhook = await fetch(`${BASE}/webhooks`, {
  method: "POST", headers,
  body: JSON.stringify({
    url: "https://your-server.com/webhook",
    eventTypes: ["tweet.new"],
  }),
}).then(r => r.json());

Pitfalls:

• Webhook secret is shown only once at creation
• Verify HMAC signature (

  X-Xquik-Signature

  header) before processing
• Respond within 10 seconds; queue slow processing for async

8. Trending Topics

When to use: Get current trending topics for a region.

Endpoint:

GET /trends?woeid=1

MCP tool:

get-trends

Free, no quota consumed.

Error Handling

Retry only

429

5xx

4xx

Retry-After

Conventions

• IDs are strings (bigints). Never parse as numbers
• Timestamps: ISO 8601 UTC
• Cursors are opaque. Pass

  nextCursor

  as the

  after

  query parameter
• Pagination:

  hasMore

  +

  nextCursor

  pattern across events, draws, extractions

MCP Tool Reference

22 tools available through the MCP server:

search-tweets

lookup-tweet

get-user-info

check-follow

get-trends

add-monitor

remove-monitor

list-monitors

get-events

get-event

add-webhook

remove-webhook

list-webhooks

test-webhook

run-draw

list-draws

get-draw

estimate-extraction

run-extraction

list-extractions

get-extraction

get-account