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.