Pagination & conventions

Player, event, book, and notable-game catalogs return complete lists in one response. Game-list endpoints are paginated. Pass page and page_size as query parameters. The default page size is 50 and the maximum is 100 (larger values are clamped down).

Paginated payloads share a common envelope around their results array:

{
  "count": 128,            // total matches found
  "page": 1,               // current page number
  "page_size": 50,         // items per page
  "page_count": 3,         // total number of pages
  "results": [ ... ],      // the page of items
  "next": "/api/v1/games/?q=...&page=2&page_size=50",
  "previous": null         // null on the first page
}

Resolve relative next, previous, and resource URLs against https://classicchess.com. Follow next until it is null. A page number beyond the final page currently returns the final page. The master game search returns at most 500 matching games per query (reported as result_limit in the response); refine your query q to narrow large result sets. Search strings are capped at 120 characters and 8 searchable terms.