find-viral-tweets
Find Viral Tweets
Surface the highest-engagement tweets matching a topic, user, or hashtag. Read-only.
Endpoints
| Endpoint | Purpose | Cost |
|---|---|---|
| GET /x/tweets/search | Search with engagement filters | Read tier |
| POST /extractions with toolType=tweet_search_extractor | Bulk viral tweet extraction | Per-row |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Quick reference
GET /x/tweets/search?q=<q+min_faves:1000+min_retweets:100>&queryType=Top
-> { tweets: Tweet[], nextCursor?: string }
More from xquik-dev/x-twitter-scraper
x-twitter-scraper
Use when the user needs X (Twitter) data or confirmation-gated X actions through Xquik: tweet search, user lookup, follower extraction, media download, monitoring, webhooks, MCP, SDKs, posting, likes, DMs, and profile updates. Requires a Xquik API key. Never ask for X login material.
663x-trends
Use when the user wants to know what is trending on X (Twitter) right now. Fetches current trending topics, hashtags, and volumes by country. Useful for content ideation, timely posts, news monitoring, and spotting viral moments.
12search-tweets
Use when the user wants to search tweets on X (Twitter) by keyword, phrase, hashtag, from a specific user, within a date range, or with engagement filters. Covers both the live search endpoint (latest matches) and bulk tweet search extractions (up to 1,000 tweets per job). Returns tweet IDs, text, authors, metrics, and timestamps.
11export-tweets-csv
Use when the user wants to export X (Twitter) data to CSV, JSONL, or XLSX. Covers exporting extraction results (tweets, followers, mentions, giveaway entrants) and formatting them for spreadsheets or pipelines. Download handling only.
11find-bangers
Use when the user asks for 'bangers' on X (Twitter) - breakout tweets with exceptional engagement relative to the author's usual performance. Surfaces anomalously high-performing tweets for inspiration or trend-spotting. Read-only.
11track-competitors
Use when the user wants to track competitor accounts on X (Twitter). Measures their growth, benchmarks engagement, surfaces their best-performing tweets, and creates ongoing monitors only after explicit approval.
10