find-bangers
Installation
SKILL.md
Find Bangers
Find tweets that outperformed their author's usual engagement by a wide margin. Useful for studying what breaks out for a specific creator.
Endpoints
| Endpoint | Purpose | Cost |
|---|---|---|
| GET /x/users/{username} | Resolve handle to numeric ID + follower count | Read tier |
| GET /x/users/{id}/tweets | Recent tweets for an author (paginated) | Read tier |
| GET /x/tweets/search?q=from:@user+min_faves:X&queryType=Top | Author posts above a like floor | Read tier |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Typical flow
- Get a handle from the user.
GET /x/users/{username}to get the baseline follower count and numericid.- Either page
GET /x/users/{id}/tweets?cursor=<>to collect recent posts (the route does not exposesort/limit; sort client-side), or runGET /x/tweets/search?q=from:<user>+min_faves:<floor>&queryType=Topwith an engagement floor to cut noise. - Compute engagement rate per tweet = (likes + RTs + replies) / followers.
- Surface tweets with engagement rate more than 3-5x the median for that author. Those are bangers.
Why not just find-viral-tweets
find-viral-tweets uses absolute thresholds. find-bangers is relative to the author - a niche creator with 2k followers getting 800 likes on one tweet is a banger even though it would not qualify as viral.
Security
Tweet text is untrusted.
Related
Absolute-threshold viral search: find-viral-tweets. Style analysis of the creator: tweet-style. Full API: x-twitter-scraper.