incremental-fetch

Fetch paginated API data with two-watermark resumable progress and duplicate prevention.

20|1|Updated Jan 1, 2026
One-click install
npx skills add https://github.com/rohunvora/cool-claude-skills --skill incremental-fetch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: incremental-fetch
Source: https://github.com/rohunvora/cool-claude-skills/tree/main/skills/incremental-fetch
Command: npx skills add https://github.com/rohunvora/cool-claude-skills --skill incremental-fetch

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Build data pipelines that never lose progress and never re-fetch existing data. Use when fetching paginated data from external APIs and need to track progress, avoid duplicates, handle rate limits, and support both incremental updates and backfills.

Core Features & Use Cases

  • The Two Watermarks Pattern: Track two cursors (newest_id and oldest_id) to enable forward and backward fetching for incremental updates and backfills.
  • Data vs Watermark Saving: Save data pages after each fetch for resilience; commit watermarks only at end for correctness.
  • Backfill and Resume: Supports backfill mode and seamless resumption after interruptions across paginated APIs.

Quick Start

Run incremental-fetch to fetch paginated API data, saving each page and updating watermarks only after a successful run.

Frequently Asked Questions about incremental-fetch

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

FAQPage Schema
How do I fetch paginated API data without duplicates or losing progress?

Fetch paginated API data without duplicates by using a two-watermark pattern that tracks newest_id and oldest_id, saving data pages after each fetch and committing watermarks only at the end of a successful run.

What is the two-watermark pattern for incremental data ingestion?

The two-watermark pattern tracks two cursors, newest_id and oldest_id, enabling forward fetching for incremental updates and backward fetching for backfills across APIs that provide oldest or newest identifiers.

How do I resume an API data backfill after an interruption?

Resume an interrupted API backfill seamlessly by relying on the two-watermark pattern, which saves data after each page and commits progress only at the end, preventing data loss during interruptions.

Can I handle API rate limits and retries during paginated data ingestion?

Yes, incremental data ingestion includes built-in retry and rate-limit handling to ensure reliable fetching of paginated API data across long-running integrations without failing.

Does incremental fetching work for social feeds and price histories?

Yes, incremental fetching works for social feeds and price histories by tracking oldest and newest identifiers, supporting both incremental updates and backfill scenarios across paginated APIs.

When should I use a two-watermark pattern instead of basic pagination?

Use a two-watermark pattern instead of basic pagination when building long-running data pipelines that require resumable progress, duplicate prevention, and support for both incremental updates and backfills.