run-giveaway

Installation
SKILL.md

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

Installs
9
GitHub Stars
128
First Seen
Apr 23, 2026
run-giveaway — xquik-dev/x-twitter-scraper