Why does my API call only return the first page?

This usually occurs when the pagination field names used in your code don't match the actual API response (e.g., using 'next' instead of 'nextPageCursor') or when the loop termination condition is met prematurely.

What is the difference between cursor and page-based pagination?

Page-based pagination uses incremental integers (page 1, 2, 3), while cursor-based pagination uses a unique token from the current response to fetch the next set, which is more stable for frequently changing datasets.

How can I make my API imports faster?

Check the API documentation for the maximum supported 'page_size'. Increasing this value reduces the total number of network requests and minimizes exposure to rate limits.

How do I verify the actual pagination field names?

Use a command-line tool like curl combined with jq (e.g., 'curl API_URL | jq keys') to inspect the exact keys returned in the JSON response before writing your implementation.

Can this skill help with rate limiting issues?

Yes, by teaching you to optimize page sizes, the skill helps you fetch more data per request, which significantly reduces the total number of API calls that count against your rate limit.

API Pagination Debugger

Name: API Pagination Debugger
Author: ngpestelos

byngpestelos

0•

API開発

Diagnoses and resolves common API pagination failures through systematic response verification and implementation pattern matching.

This skill provides a rigorous methodology for troubleshooting broken API integrations where data imports stop prematurely or return duplicate results. It guides developers through identifying the specific pagination pattern used by an endpoint—whether cursor, page, offset, or link-based—and ensures implementation matches the actual API response structure rather than documentation-based assumptions. By emphasizing manual verification with tools like curl and jq, it helps eliminate bugs related to case-sensitive field names and inefficient page sizes, ultimately reducing API calls and improving data ingestion reliability.

主な機能

01Identification of distinct pagination patterns including Cursor, Page, Offset, and Link-based

02Implementation templates for correct cursor-advancement and page-increment logic

030 GitHub stars

04Optimization techniques for maximizing page size and reducing rate limit exposure

05Systematic workflow for reproducing and diagnosing pagination stalls

06Manual verification steps using curl and jq to validate actual API response structures

ユースケース

01Migrating API integrations between versions with different pagination schemes

02Fixing data import scripts that stop after the first page of results

03Optimizing high-volume data synchronization to minimize total API call overhead

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ngpestelos/readwise-mcp-server api-pagination-debugging

For use in Claude.ai and ChatGPT

Download Skill