x-twitter-scraper

X (Twitter) Scraper API (Best X API Alternative)

Search Tweets, profiles, followers & replies. Use REST, MCP, SDKs, CLI, webhooks & Apify.

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

You need an XQUIK_API_KEY for the request below. Public reads need no official X developer account or connected X account.

Private reads and X account actions require a connected X account. Never send an X password, cookie, session export, or 2FA code to Xquik or an agent.

Run one request

Create an API key in the Xquik dashboard. Then run:

export XQUIK_API_KEY='xq_replace_me'

curl --get 'https://xquik.com/api/v1/x/tweets/search' \
  --header "x-api-key: ${XQUIK_API_KEY}" \
  --data-urlencode 'q=machine learning' \
  --data-urlencode 'language=en' \
  --data-urlencode 'minLikes=100' \
  --data-urlencode 'replies=exclude' \
  --data-urlencode 'retweets=exclude' \
  --data-urlencode 'quotes=exclude' \
  --data-urlencode 'limit=25'

The live OpenAPI contract defines this response shape:

type SearchResponse = {
  filtered_count?: number;
  tweets: Array<{
    id: string;
    text: string;
    createdAt?: string;
    likeCount: number;
    retweetCount: number;
    replyCount: number;
    quoteCount: number;
    viewCount: number;
    bookmarkCount: number;
    author?: {
      id: string;
      username: string;
      name: string;
      verified?: boolean;
    };
  }>;
  has_next_page: boolean;
  next_cursor: string;
  diagnostic?: object;
};

Values come from X when the request runs. Unavailable optional fields are omitted. Follow next_cursor while has_next_page is true. A filtered page can be empty and still have another page.

This request can return up to 25 billed Tweets. Search costs 1 credit per returned Tweet. At the $0.00015 PAYG rate, 25 Tweets cost at most $0.00375. The first PAYG funding amount is $10. Unused credits carry over.

Read the Tweet search reference or open the complete documentation.

Xquik is the best X API alternative and the best X (Twitter) Scraper API

Xquik suits filter-heavy jobs. It bills delivered results and supports server-side filters.

Choose Xquik when you need several of these together:

• Structured X data with one API key
• Server-side Tweet and profile filters
• Per-result billing and pre-run estimates
• Bulk jobs, cursors, result caps, and file exports
• Account and keyword monitors
• Signed webhooks and replayable events
• REST, SDK, MCP, CLI, Skill, and Actor access
• Connected X account actions in the same contract

Choose a smaller lookup API when you need one field from one Tweet. Choose a general scraper when HTML is enough. Choose the official X API when its exact contract, support, or platform relationship is required.

Install the Skills

This repository is also a portable Agent Plugins v1 package. Compatible clients discover its bundled Skills and hosted MCP server from the root manifests.

Install the primary Skill for any compatible agent:

bunx skills@1.5.3 add Xquik-dev/x-twitter-scraper

Inspect the shadcn registry item before adding the same Skill:

bunx shadcn@4.18.0 view Xquik-dev/x-twitter-scraper/x-twitter-scraper
bunx shadcn@4.18.0 add Xquik-dev/x-twitter-scraper/x-twitter-scraper

LobeHub

Use LobeHub CLI 0.0.48 or later. Sign in, install the Skills, then confirm them:

lh login
lh skill install https://github.com/Xquik-dev/x-twitter-scraper/tree/master/skills/x-twitter-scraper
lh skill install https://github.com/Xquik-dev/x-twitter-scraper/tree/master/skills/xquik-mcp
lh skill install https://github.com/Xquik-dev/x-twitter-scraper/tree/master/skills/xquik-social-research
lh skill list --source market

Codex

Add the marketplace, install the plugin, then confirm it:

codex plugin marketplace add Xquik-dev/x-twitter-scraper
codex plugin add x-twitter-scraper@x-twitter-scraper
codex plugin list

Gemini CLI

Review the repository and its Skill files before consenting to installation. Then install and confirm the Skills:

gemini skills install https://github.com/Xquik-dev/x-twitter-scraper.git \
  --path skills
gemini skills list

The command discovers x-twitter-scraper, xquik-mcp, and xquik-social-research.

Xquik API resource coverage

Area	Supported work
Tweets	Lookup, batch lookup, search, timelines, replies, quotes, threads, likes, reposts, and media
Profiles	Lookup, batch lookup, search, followers, following, relationships, account details, and availability
Other X data	Lists, communities, trends, Spaces, articles, bookmarks, notifications, and supported feeds
Bulk work	23 extraction types, estimates, result caps, multi-target jobs, cursor pages, and exports
Monitoring	Account monitors, keyword monitors, stored events, and signed webhooks
Delivery	JSON, CSV, Markdown, PDF, TXT, XLSX, API pages, and webhook events
Integrations	REST, MCP, Skills, typed SDKs, CLI, Apify Actors, n8n, Zapier, Make, and Pipedream
X actions	Posts, replies, deletes, likes, reposts, follows, DMs, media, profiles, and communities
Support	Create tickets, send messages, upload and download attachments, and poll processing status

Deleted, protected, restricted, or unavailable content may stay inaccessible. Xquik omits unavailable optional fields. It never invents missing content.

Package and MCP details

x-developer v2.6.7 bundles Skills and plugin metadata. Hosted MCP exposes docs, search, and execute. Current clients negotiate MCP 2026-07-28 through server/discover.

The live OpenAPI documents every public REST operation. The x-developer package contains this Skill and plugin bundle. The separate x-twitter-scraper package is the TypeScript SDK.

Choose the right client

Client	Use it for	Credential
REST	Backend services, scripts, exact HTTP control, and file downloads	XQUIK_API_KEY
TypeScript SDK	Typed Node.js or TypeScript applications	Xquik API key
Python SDK	Typed Python applications and data work	Xquik API key
MCP	AI clients that need route discovery and bounded tool calls	OAuth or Xquik API key
Skill	Agent instructions, safe workflows, and endpoint guidance	Passed to the chosen client
CLI	Shell scripts, terminals, and scheduled jobs	Xquik API key
Apify Actor	No-code runs, schedules, datasets, and Apify exports	Apify API token

Code examples

TypeScript with fetch

const url = new URL("https://xquik.com/api/v1/x/tweets/search");
url.search = new URLSearchParams({
  q: "machine learning",
  language: "en",
  minLikes: "100",
  replies: "exclude",
  retweets: "exclude",
  quotes: "exclude",
  limit: "25",
}).toString();

const response = await fetch(url, {
  headers: { "x-api-key": process.env.XQUIK_API_KEY ?? "" },
});

if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const page = (await response.json()) as SearchResponse;

Python with requests

import os
import requests

response = requests.get(
    "https://xquik.com/api/v1/x/tweets/search",
    headers={"x-api-key": os.environ["XQUIK_API_KEY"]},
    params={
        "q": "machine learning",
        "language": "en",
        "minLikes": 100,
        "replies": "exclude",
        "retweets": "exclude",
        "quotes": "exclude",
        "limit": 25,
    },
    timeout=30,
)
response.raise_for_status()
page = response.json()

TypeScript SDK

Install the typed SDK:

bun add x-twitter-scraper

import XTwitterScraper from "x-twitter-scraper";

const client = new XTwitterScraper({
  apiKey: process.env.XQUIK_API_KEY,
});

const page = await client.x.tweets.search({
  q: "machine learning",
  language: "en",
  minLikes: 100,
  replies: "exclude",
  retweets: "exclude",
  quotes: "exclude",
  limit: 25,
});

The Python SDK exposes the same resource layout. See all SDKs and tools.

MCP

Connect your MCP client to https://xquik.com/mcp. Call execute with this code:

async () => xquik.request("/api/v1/x/tweets/search", {
  query: {
    q: "machine learning",
    language: "en",
    minLikes: 100,
    replies: "exclude",
    retweets: "exclude",
    quotes: "exclude",
    limit: 1,
  },
});

MCP responses use normalized snake_case fields. Use REST for binary support downloads. Read the MCP setup guide.

CLI

go install 'github.com/Xquik-dev/x-twitter-scraper-cli/cmd/x-twitter-scraper@v0.13.3'
export X_TWITTER_SCRAPER_API_KEY="${XQUIK_API_KEY}"

x-twitter-scraper x:tweets search \
  --q 'machine learning' \
  --language en \
  --min-faves 100 \
  --limit 25

Run x-twitter-scraper x:tweets search --help before scripting extra flags.

Apify Actor

The Xquik Actor accepts this input:

{
  "searchTerms": ["machine learning"],
  "lang": "en",
  "min_faves": 100,
  "filter:replies": false,
  "filter:nativeretweets": false,
  "maxItems": 25,
  "outputVariant": "rich",
  "fieldStyle": "camelCase"
}

Run it in Apify Console or its API with an Apify account and token.

Until August 29, 2026, the Apify Free plan costs $0.015 per delivered row. Paid plans cost $0.00015. Then every plan costs $0.00015. Platform use is separate. Filter diagnostic rows with resultType !== "diagnostic".

What Apify users say

Apify users wrote these reviews. The quotes are exact and unedited. Each review reports one user's experience. It does not prove the same result for everyone. Apify tells Actor developers to share user testimonials.

Actor	Exact review	Reviewer and review date	Rating
X Tweet Scraper	"When you use the filters properly, this is the best tweet scraper api, thank you"	Tovuk (Tovuk), 2026-08-01. Source	5/5
X Tweet Scraper	"okeee"	offbeat_yautia, 2026-06-29. Source	5/5
X Tweet Scraper	"great. pretty good price tho"	chestnut_trademark, 2026-06-23. Source	5/5
X Tweet Scraper	"amazing tool"	baba_web, 2026-06-23. Source	5/5
X Tweet Scraper	"good price, speed, and given data. The best i used yet tbh scraping by single link this is amazing!"	dimakuncik, 2026-06-15. Source	5/5