going-viral
How to Go Viral on X
Full viral-content workflow: find what is working right now, draft in the user's voice, score against the algorithm, and hand off to posting.
Endpoints used across this workflow
| Purpose | Endpoint |
|---|---|
| Recent viral references | GET /x/tweets/search?sort=top&min_faves=5000 |
| User style | GET /styles/{username} |
| Ideas | POST /compose (step=ideas) |
| Draft | POST /compose |
| Score | POST /compose (step=score) |
| Optimize | POST /compose (step=optimize) |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Typical flow
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.
650x-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.
11find-viral-tweets
Use when the user wants to find viral or high-engagement tweets on X (Twitter) around a topic, from a specific author, or across a hashtag. Filters by minimum likes, retweets, or views. Read-only discovery tool.
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.
11