run-giveaway
Run Giveaway on X
Pull entrants from a seed tweet, filter by rules (min followers, account age, must-follow, must-retweet), pick verifiable winners, and export the list.
Endpoints
| Endpoint | Purpose | Cost |
|---|---|---|
| POST /draws | Create a draw from a seed tweet | Draw tier |
| GET /draws/{id} | Get draw status and winners | Read tier |
| GET /draws/{id}/entrants | Paginated entrant list | Read tier |
| GET /draws/{id}/export?format=csv | Export entrants/winners | Read tier |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Quick reference
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