for-you-feed

Fetch the authenticated X For You timeline with cursor pagination.

177|17|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/Xquik-dev/x-twitter-scraper --skill for-you-feed
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: for-you-feed
Source: https://github.com/Xquik-dev/x-twitter-scraper/tree/main/skills/for-you-feed
Command: npx skills add https://github.com/Xquik-dev/x-twitter-scraper --skill for-you-feed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading the X For You home timeline programmatically enables agents to access real-time tweets without manual UI interaction and scrolling.

Core Features & Use Cases

  • Cursor-paginated timeline: fetches the For You feed in pages.
  • Seen tweet suppression: pass seenTweetIds to avoid duplicates during sequential fetches.
  • Read-only access: safe integration for analytics, summaries, or agent workflows.

Quick Start

Call GET /x/timeline with an API key to fetch the timeline and paginate using nextCursor.

Frequently Asked Questions about for-you-feed

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch the X For You timeline via API?▼

To fetch the X For You timeline via API, call GET /x/timeline on https://xquik.com/api/v1 using the x-api-key header. The endpoint returns a tweets array and an optional nextCursor for cursor-based pagination.

What is cursor-based pagination for the Twitter home timeline?▼

Cursor-based pagination for the Twitter home timeline uses a nextCursor token from each API response to fetch the next page of tweets. You pass this cursor in subsequent GET /x/timeline requests to sequentially retrieve older timeline entries.

How do I prevent duplicate tweets when loading the For You feed incrementally?▼

To prevent duplicate tweets when loading the For You feed, pass the seenTweetIds parameter in your API request. This suppresses already-seen tweets, ensuring clean incremental loading for analytics or agent workflows.

Does the X timeline API provide write access for posting tweets?▼

No, the X timeline API provides read-only access. It is designed for safe integration into analytics, summaries, or agent workflows to fetch real-time tweets without manual UI interaction or scrolling.

What authentication is required to read the For You timeline programmatically?▼

Reading the For You timeline programmatically requires an x-api-key header for authentication. You must include this API key in your GET request to the https://xquik.com/api/v1/x/timeline endpoint.