for-you-feed
For You Feed (Home Timeline)
Fetch the For You timeline the way it appears in the app. Cursor-paginated; the caller is authenticated via API key (the server picks the connected account).
Endpoints
| Endpoint | Purpose | Cost |
|---|---|---|
| GET /x/timeline | For You home timeline | Read tier |
Base URL: https://xquik.com/api/v1. Auth: x-api-key: xq_... header.
Quick reference
GET /x/timeline?cursor=<optional>&seenTweetIds=<comma-separated>
-> { 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.
671x-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