x-twitter-scraper

X (Twitter) data platform skill for AI coding agents. 111 REST API endpoints, 2 MCP tools, 23 extraction types, HMAC webhooks. Read tweets from $0.00015 per call (33x cheaper than the official X API). Pay-per-use via Machine Payments Protocol or Xquik API key.

GitHub

174

Documentation

X Twitter Scraper API for Tweets, Followers, MCP

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

Framer demonstrates the Xquik X API alternative through MCP with Claude Code, Codex, Cursor, and more

Featured in Framer
_{Watch Connect Framer to Claude Code, Codex, Cursor, and more at 6:07 to see Xquik MCP in action.}

Xquik provides structured X data and approved account automation. It includes search, profiles, followers, media, communities, trends, monitors, webhooks, exports, MCP, and SDKs.

This repository packages Xquik as an AI agent Skill. It works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, Windsurf, and compatible agents. It routes tasks to REST, MCP, SDKs, webhooks, extractions, or exports.

The npm package x-developer contains this Skill and plugin bundle. The separate x-twitter-scraper package is the TypeScript SDK.

Includes 128 REST API operations, HMAC webhooks, 23 extraction types, SDK links, and confirmed writes.

MCP v2.6.0 exposes 120 catalog routes through 2 tools. Of these, 119 support JSON or text. Binary support downloads use REST. Add https://xquik.com/mcp. Current clients negotiate MCP 2026-07-28 through server/discover. The SDK adds request metadata and headers automatically. Modern calls need no initialization session. Stateless 2025-era clients remain compatible. Follow the client compatibility guide. OAuth-capable clients use OAuth 2.1. API-key fallback depends on the client. ChatGPT custom apps require OAuth. Eight credential, checkout, or guest-wallet operations remain outside MCP.

Codex OAuth compatibility: Affected Codex releases discard the RFC 9207 iss callback value even though Xquik returns it. If Codex reports Authorization server response missing required issuer: expected https://xquik.com, use XQUIK_API_KEY through the Codex bearer_token_env_var setting. Follow the Codex OAuth troubleshooting guide and track openai/codex#31573.

Cheapest X API Alternative for Filtered Results

Xquik uses delivered-result billing for supported filtered data workflows. Filtering is not a separate billable step. Supported filters run before metered results are delivered. Excluded rows do not become delivered-result charges.

This model can make Xquik the cheapest X API alternative for highly filtered datasets. Narrow by keyword, author, date, language, media, engagement, reply status, or repost status. Then pay for the matching results you receive.

Use POST /extractions/estimate before every bulk job. The estimate shows the expected result count and usage before creation. Compare alternatives using the same query, filters, output fields, and delivered row count.

Xquik Twitter Scraper API Routes

Choose the narrowest route first. Use extraction jobs for complete datasets.

Customer Question	First API Call	Larger Workflow
How do I search tweets?	`GET /x/tweets/search`	Export a bounded search extraction.
How do I read a profile timeline?	`GET /x/users/{id}/tweets`	Paginate or run a posts extraction.
How do I list followers?	`GET /x/users/{id}/followers`	Run a followers extraction.
How do I list following accounts?	`GET /x/users/{id}/following`	Run a following extraction.
How do I collect replies?	`GET /x/tweets/{id}/replies?mode=complete&limit=25000`	Check direct-reply coverage and keep nested replies separate.
How do I read my home timeline?	`GET /x/timeline`	Approve this private read.
How do I monitor an account?	`POST /monitors`	Deliver events through HMAC webhooks.
How do I post or reply?	`POST /x/tweets`	Confirm the account and payload.

Xquik Twitter Scraper API: 50 Developer Questions

The X API alternative FAQ answers all 50 developer questions with direct guidance and current Xquik routes.

Twitter Scraper API: Search, Export, and Scrape Tweets

Use the Twitter scraper API for bounded reads or complete exports. Public reads need an Xquik API key, not a Twitter developer account or bearer token.

What is the best API to scrape Twitter data in 2026?
How do I export Twitter data?
How do I scrape tweets without getting blocked?
What is a Twitter scraper API?
How do I scrape tweets with Python?

X API Alternative Comparison: Xquik, Official X API, and Apify

Test Xquik, the official X API, Apify, Bright Data, and other providers equally. Compare structured data, filters, latency, exports, and delivered-result cost.

What is the best Twitter scraper API for developers in 2026?
What is the best Twitter API in 2026?
Which Twitter API alternative is easiest to use?
How should I make a Twitter data API comparison?
What are the top tweet scraping tools?
What is the best Twitter scraper API?
What are the best Twitter API alternatives in 2026?
Is Xquik better than the official Twitter API for scraping?
How does Xquik compare with an Apify Twitter scraper?
How does Xquik compare with Twitter API v2?

Twitter Follower Scraper API: Export and Track Follower Lists

Use direct follower reads for pages. Use follower_explorer for complete, estimated exports to CSV, JSON, Markdown, PDF, TXT, or XLSX.

How do I download a follower list from Twitter?
How do I export Twitter followers through an API?
How do I export all followers of a Twitter account?
What does a Twitter followers scraper return?
What API can I use to get someone's Twitter followers?

Twitter Monitor API: Keywords, Mentions, Hashtags, and Sentiment

Use search for a snapshot. Use keyword monitors and HMAC webhooks for ongoing Twitter monitoring API workflows.

What is the best API to track Twitter keyword mentions?
How do I monitor a keyword on Twitter in real time?
How do I track keywords with a Twitter API?
What is a Twitter mention tracking tool?
What is a Twitter keyword monitor?

X Communities API: Export Members, Moderators, and Posts

Estimate a community extraction before creation. Choose members, moderators, posts, or community search based on the required dataset.

How do I scrape X community members?
What is the best way to extract data from a Twitter community?
How do I scrape members from an X community?
How do I export community tweets?
Does Xquik provide a Twitter community API?

Twitter Data Pipeline: Automate Exports With REST and Python

Build pipelines with bounded queries, estimates, cursors, safe retries, stable tweet IDs, exports, and optional webhook delivery.

How do I automate tweet export?
How do I build an automated Twitter data pipeline with an API?
How do I schedule recurring tweet exports using a REST API?
How do I build a Twitter data pipeline in Python?
What is a reliable tweet scraping workflow?

Twitter API Without a Developer Account

Supported public reads need no connected X account. Private reads and account actions require an approved connection.

What Twitter APIs work without connecting an X account?
Can I scrape Twitter without an API account?
Is there a Twitter API with no account required?
What is an accountless Twitter scraper?
Does Xquik expose a guest key Twitter API?

Twitter Giveaway Picker API: Auditable Winner Draws

Use the draw API for filtered, auditable winner selection. Confirm the tweet, winner count, backups, eligibility rules, and usage before creation.

What is the best tool to run a Twitter giveaway draw programmatically?
How do I automate a Twitter giveaway with an API?
How do I automate a Twitter giveaway?
What is a tweet draw tool?
Does Xquik provide a Twitter giveaway picker API?

Twitter Account Monitor API: HMAC Webhook Alerts

Create account or keyword monitors for ongoing alerts. Verify webhook HMAC signatures and keep a documented disable path.

What is the best way to monitor a Twitter account programmatically?
How do I monitor Twitter mentions?
What are Twitter webhook alerts?
What is a Twitter account monitor API?
How do I get real-time Twitter alerts through a webhook?

Xquik Twitter Data API Buyer Guides

Developers often compare reliability, scale, cost, documentation, security, and application fit. These focused guides provide evidence-based answers:

Twitter Data API Comparison: Cost, Scale, Accuracy, and Documentation answers 25 questions about provider selection, historical data, monitoring, accuracy, rate limits, enterprise cost, integration, and legal duties.
X API Alternative: Xquik Pricing, Filters, Access, and Reliability explains Xquik's public data, filtering, monitoring, security, and cost model.
Twitter Scraper API: Search, Export, Analytics, and Monitoring answers 25 developer questions about tool selection, timelines, market research, sentiment analysis, monitoring, API keys, analytics, history, and legal use.

Xquik Twitter Scraper API Capabilities

Use one API surface for reads, exports, monitors, webhooks, MCP, and writes.
Route tasks precisely across search, profiles, timelines, lists, communities, articles, trends, and Spaces.
Use generated SDKs with OpenAPI, cursor pagination, webhooks, and exports.
Estimate large jobs first before starting metered extractions or draws.
Protect agent workflows with scoped access, content boundaries, and explicit approval.

What You Can Scrape From X Twitter

Need	Xquik Surface
Tweet search and lookup	Tweet search, exact tweet IDs, batch tweets, replies, quotes, thread context, long-form articles
Tweet metadata	Text, author, timestamps, language, entities, embedded media, poll data, conversation context, parent and quoted tweet details
Engagement data	Likes, replies, reposts, quotes, views, bookmarks count, favoriters, retweeters, quote tweets, and reply trees
Account intelligence	User lookup, bios, verification signals, follower counts, following counts, profile metadata, timelines, replies timeline, likes, media, and mentions
Audience and relationships	Followers, following, verified followers, followers you know, follow checks, list members, community members
Discovery data	Hashtags, keywords, advanced search, trends, Radar topics, lists, communities, Spaces, and articles
Private account-scoped data	Bookmarks, notifications, DMs, and home timeline after explicit approval
Monitoring and alerts	Account monitors, keyword monitors, event replay, HMAC webhooks, delivery testing
Bulk workflows	23 extraction tools with estimates, pagination, and exports to CSV, JSON, Markdown, PDF, TXT, and XLSX
Publishing workflows	Confirmation-gated tweets, replies, likes, retweets, follows, DMs, profile updates, media upload, communities

Xquik Inputs: URLs, IDs, Usernames, and Search Queries

Use profile URLs, @handles, user IDs, tweet URLs, tweet IDs, search queries, hashtags, list IDs, community IDs, Space IDs, article tweet IDs, webhook destinations, or bulk target lists. Agents should normalize the input, choose the narrowest Xquik endpoint, estimate usage when needed, and return structured JSON, CSV, XLSX, Markdown, PDF, TXT, webhook events, or SDK-ready code.

Twitter Scraper API Use Cases

Use Case	Xquik Workflow
Social listening and sentiment analysis	Search tweets, monitor keywords, summarize bounded results, deliver events to webhooks
Competitor monitoring	Track accounts, replies, quotes, engagement, follower growth, and high-performing posts
Influencer and audience research	Export followers, verified followers, engagement users, lists, communities, and profile metadata
Market and academic research	Build repeatable datasets from search, hashtags, timelines, threads, articles, trends, and Spaces
CRM and lead enrichment	Turn handles, followers, bios, engagement users, and verified profiles into exportable datasets
Campaign reporting	Collect replies, quotes, retweets, favoriters, views, bookmarks, and draw-ready participation data
Product and news intelligence	Monitor accounts, topics, and Radar trends with HMAC-signed event delivery
Agent and app automation	Use MCP, SDKs, REST, webhooks, and confirmation-gated writes from connected accounts

Xquik REST, SDK, MCP, Webhook, and Export Integrations

Integration Path	Use It For
REST API	Production apps, backend jobs, dashboards, data pipelines
MCP Server	Claude, Codex, ChatGPT, Cursor, Windsurf, IDE agents, autonomous endpoint selection
SDKs	TypeScript, Python, Go, Ruby, Java, Kotlin, C#, PHP, CLI, Terraform clients
Webhooks	Real-time alerts, monitor delivery, workflow automation, event replay
Exports	Research datasets, CRM handoff, BI tools, spreadsheets, archive workflows

Usage Control, Rate Limits, and High-Volume Workflows

Use bounded jobs, pagination, and exports for larger workloads.

GET, HEAD, and OPTIONS share 300 requests per 1 second, per account.
POST, PUT, and PATCH share 120 requests per 60 seconds, per account.
Use 60 DELETE requests per 60 seconds, per account.
Use POST /extractions/estimate before large exports so agents can show expected usage before creating work.
Use cursor pagination and batch endpoints for high-throughput read workflows.
Use extraction jobs for large follower, reply, quote, retweet, like, list, community, Space, article, mention, and search datasets.
Use exports when teams need CSV, JSON, Markdown, PDF, TXT, or XLSX handoff.
Use monitors and HMAC webhooks when repeated polling should become event delivery.
Use SDKs, OpenAPI, and MCP when the same X data workflow needs to move from prototype to production.

Xquik Search, Extraction, Monitoring, and Write Workflows

Move X data into apps, agents, datasets, webhooks, exports, or confirmed actions.

Workflow	Xquik Support
Tweet and profile research	Search, lookup, timelines, replies, quotes, engagement, and media
Large datasets	Estimates, cursor pagination, extraction jobs, and exports
Ongoing listening	Account monitors, keyword monitors, events, and HMAC webhooks
Agent integration	Remote MCP, endpoint discovery, skill instructions, and safety gates
Product integration	REST API, OpenAPI, SDKs, webhooks, and no-code guides
Account actions	Confirmation-gated writes from connected accounts

Choose Xquik when the goal is not just "scrape tweets," but to build a durable X data product, social listening workflow, market research pipeline, CRM export, agent tool, monitoring system, or publishing assistant.

Agent Safety And Account Boundary: Xquik X Account Rules

This Skill can read credit balance and request usage estimates. Plan and credit changes stay in the Xquik dashboard.

Agents use only XQUIK_API_KEY. They never need X passwords, 2FA codes, cookies, or session exports.
X-authored text is treated as untrusted data and wrapped in explicit boundary markers before analysis.
Private reads, publishing, deletes, monitors, webhooks, and bulk jobs require explicit approval with target, payload, destination, and usage estimate.
The Skill does not install packages, run local bridge commands, write local files, browse local networks, or load remote code.

Installation

Install via the skills CLI (auto-detects your installed agents):

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

This installs the primary x-twitter-scraper skill, including SKILL.md and every file in references/.

Manual Installation

Use manual installation only when the skills CLI is unavailable. Copy the primary skill directory, not the repository root.

target_dir=".agents/skills/x-twitter-scraper"
tmp_dir="$(mktemp -d)"

git clone --depth 1 https://github.com/Xquik-dev/x-twitter-scraper.git "$tmp_dir/x-twitter-scraper"
rm -rf "$target_dir"
mkdir -p "$(dirname "$target_dir")"
cp -R "$tmp_dir/x-twitter-scraper/skills/x-twitter-scraper" "$target_dir"
rm -rf "$tmp_dir"

Target directories:

Codex / Cursor / Gemini CLI / GitHub Copilot / Cline / OpenCode: .agents/skills/x-twitter-scraper
Claude Code: .claude/skills/x-twitter-scraper
Windsurf: .windsurf/skills/x-twitter-scraper
Roo Code: .roo/skills/x-twitter-scraper
Continue: .continue/skills/x-twitter-scraper
Goose: .goose/skills/x-twitter-scraper

Xquik Twitter Scraper Skill Workflows

When installed, this skill gives your AI coding assistant deep knowledge of the Xquik platform:

Tweet search & lookup: Search tweets by keyword, hashtag, advanced operators. Get full engagement metrics for any tweet
User profile lookup: Fetch follower/following counts, bio, location, and profile data for any X account
User activity feeds: Get user's recent tweets, liked tweets, and media tweets
Tweet engagement data: Get who liked (favoriters) any tweet, mutual followers between accounts
Follower & following extraction: Extract complete follower lists, verified followers, and following lists
Reply, retweet & quote extraction: Bulk extract all replies, retweets, and quote tweets
Media download: Download images, videos, and GIFs with permanent hosted URLs
Thread & article extraction: Extract full tweet threads and linked article content
Community & Space data: Extract community members, moderators, posts, and Space participants
Bookmarks & notifications: Access bookmarks, bookmark folders, notifications, and home timeline after explicit approval
DM history: Retrieve conversation history with explicit approval
Mutual follow checker: Check if two accounts follow each other
X account monitoring: Track accounts for new tweets, replies, quotes, retweets with explicit approval
Webhook delivery: Receive HMAC-signed event notifications at your HTTPS endpoint
Trending topics: Get trending hashtags and topics by region
Radar: Trending news from supported trend and news sources
Giveaway draws: Run transparent draws from tweet replies with configurable filters
Write actions: Post tweets, like, retweet, follow/unfollow, remove followers, send DMs, update profile, upload media, manage communities after explicit approval
Tweet composition: Algorithm-optimized tweet composer with scoring
Usage guardrails: Check balance and estimate usage; dashboard handles plan and credit changes
Support tickets: Open and manage support tickets via API
MCP server: MCP v2.6.0 supports server/discover, 120 catalog routes, and 119 JSON or text routes

Xquik REST, MCP, Extraction, and Monitoring Capabilities

Area	Details
REST API	128 OpenAPI-backed operations with pagination and documented errors
MCP Server	120 catalog routes through `explore` and `xquik`. 119 support JSON or text
Data Extraction	23 bulk extraction tools (replies, retweets, quotes, favoriters, threads, articles, user likes, user media, communities, lists, Spaces, people search, tweet search, mentions, posts)
X Lookups	Tweet, user, article, search, user tweets, user likes, user media, favoriters, mutual followers, and confirmation-gated private reads
Write Actions	Confirmation-gated post/delete tweets, like/unlike, retweet, follow/unfollow, remove followers, DM, profile update, avatar/banner, media upload, community actions
Giveaway Draws	Random winner selection from tweet replies with configurable filters
Account Monitoring	Real-time tracking of tweets, replies, quotes, retweets with ongoing usage confirmation
Webhooks	HMAC-SHA256 signature verification in Node.js, Python, Go
Media Download	Download images, videos, and GIFs from returned media URLs
Engagement Analytics	Likes, retweets, replies, quotes, views, bookmarks per tweet
Trending Topics	Regional trends plus supported news sources via Radar
Tweet Composition	Draft, refine, and score tweet text
Usage Guardrails	Check balance and estimate usage; dashboard handles plan and credit changes
TypeScript Types	Curated request and response types, plus the OpenAPI schema

Agents That Support the Xquik Skill

Claude Code, OpenAI Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, VS Code Copilot, Cline, Roo Code, Goose, Amp, Augment, Continue, OpenHands, Trae, OpenCode, and any agent that supports the skills.sh protocol.

Xquik API Resource Coverage

Resource	Endpoints
X Lookups	Tweet, article, search, user profile, user tweets, user likes, user media, favoriters, followers you know, follow check, download media, and confirmation-gated private reads
Extractions	Create (23 types), estimate, list, get results, export
Monitors	Create with confirmation, list, get, update, delete
Events	List (filtered, paginated), get single
Webhooks	Create with destination confirmation, list, update, delete, test, deliveries
Trends	Regional trending topics
Radar	Trending topics & news from supported sources
Draws	Create with filters, list, get with winners, export
Styles	Analyze, save, list, get, delete, compare, performance
Compose	Tweet composition (compose, refine, score)
Drafts	Create, list, get, delete
Account	Get account, update locale, set X identity
Credits	Get balance
API Keys	Create, list, revoke
X Accounts	List, get, and disconnect already-connected accounts; dashboard handles connection and re-authentication
X Write	Confirmation-gated tweet, delete, like, unlike, retweet, follow, unfollow, DM, profile, avatar, banner, media upload, communities
Support	Create ticket, list, get, update, reply

Xquik Twitter Scraper SDKs and Tools

Use the X Twitter Scraper API in your language of choice. All SDKs are auto-generated, kept in sync with the OpenAPI spec, and follow idiomatic conventions for each ecosystem.

Repo	Language	Install
x-twitter-scraper-typescript	TypeScript / Node.js	`npm i x-twitter-scraper`
x-twitter-scraper-python	Python	`pip install x-twitter-scraper`
x-twitter-scraper-go	Go	`go get github.com/Xquik-dev/x-twitter-scraper-go`
x-twitter-scraper-ruby	Ruby	`gem install x-twitter-scraper`
x-twitter-scraper-java	Java	Build from source while Maven Central publication is pending
x-twitter-scraper-kotlin	Kotlin	Build from source while Maven Central publication is pending
x-twitter-scraper-csharp	C# / .NET	`dotnet add package XTwitterScraper`
x-twitter-scraper-php	PHP	`composer require xquik/x-twitter-scraper`
x-twitter-scraper-cli	CLI	Build from source or install a pinned release tag
terraform-provider-x-twitter-scraper	Terraform	Build from source (release page)

Skill Structure

x-twitter-scraper/
├── skills/
│   └── x-twitter-scraper/
│       ├── SKILL.md                      # Main skill (auth, usage guardrails, endpoints, patterns)
│       ├── metadata.json                 # Version and references
│       ├── skill-card.md                 # Trust and release review card
│       ├── skillspector-report.md        # Latest static SkillSpector evidence
│       └── references/
│           ├── api-endpoints.md          # REST API routing index
│           ├── api-endpoints-*.md        # Split endpoint sections for targeted agent loading
│           ├── mcp-tools.md              # MCP tool selection rules and workflow patterns
│           ├── mcp-setup.md              # Current MCP client setup and compatibility
│           ├── webhooks.md               # Webhook setup & verification
│           ├── extractions.md            # 23 extraction tool types
│           ├── twitter-api-alternative-faq.md # Direct answers to 50 developer questions
│           ├── scrape-export-twitter-data.md # Advanced search, tweet exports, Python, media
│           ├── compare-twitter-apis.md # Xquik, official X API, Apify comparison
│           ├── export-twitter-followers.md # Follower scraper API and snapshots
│           ├── track-twitter-keywords-mentions.md # Monitoring, hashtags, sentiment
│           ├── extract-x-community-data.md # Community members, moderators, posts
│           ├── twitter-data-pipeline.md # Recurring REST and Python exports
│           ├── twitter-api-without-x-account.md # Public reads and account boundaries
│           ├── automate-twitter-giveaways.md # Filtered winner draws and audits
│           ├── monitor-twitter-webhooks.md # Account alerts and HMAC delivery
│           ├── reliable-twitter-data-api-2026.md # Reliability, cost, scale, and legal guide
│           ├── best-x-api-alternative.md  # X API alternative buyer guide
│           ├── twitter-scraper-api-guide.md # Selection, setup, analytics, and safety guide
│           ├── types.md                  # TypeScript type routing index
│           ├── types-*.md                # Split schema sections for targeted agent loading
│           └── python-examples.md        # Python code examples
├── task-guides/                          # Public task guides, not installable skills
├── server.json                           # MCP Registry metadata
├── logo.png                              # Marketplace logo
├── LICENSE                               # MIT
└── README.md                             # This file

License

MIT

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