Pricing

from $1.28 / 1,000 players

Chess Ratings Aggregator

Aggregate chess player ratings from FIDE, Chess.com, Lichess, and optional 2700chess. Compare side-by-side ratings, age insights, gap to the top, countries, titles, and source usernames for top lists or single-player lookup. Export data, run via API, schedule runs, or integrate with tools.

Pricing

from $1.28 / 1,000 players

Rating

0.0

(0)

Developer

Trove Vault

Actor stats

Bookmarked

Total users

Monthly active users

15 days ago

Last modified

Categories

Other

Integrations

News

You can access the Chess Ratings Aggregator programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.1",
    "x-build-id": "eAckmghhZO3OSOu04"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/trovevault~chess-ratings-aggregator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-trovevault-chess-ratings-aggregator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/trovevault~chess-ratings-aggregator/runs": {
      "post": {
        "operationId": "runs-sync-trovevault-chess-ratings-aggregator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/trovevault~chess-ratings-aggregator/run-sync": {
      "post": {
        "operationId": "run-sync-trovevault-chess-ratings-aggregator",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "top",
              "player"
            ],
            "type": "string",
            "description": "Choose 'Top players' to fetch a leaderboard of top N players, or 'Single player' to look up one player by name or FIDE ID across all sources.",
            "default": "top"
          },
          "topN": {
            "title": "Number of top players",
            "minimum": 1,
            "type": "integer",
            "description": "Number of top players to fetch when mode is 'Top players'. Default 100. Uses FIDE's official full rating list download, so values like 500 or country-specific top 10s are supported, with runtime scaling roughly linearly.",
            "default": 100
          },
          "playerName": {
            "title": "Player name",
            "type": "string",
            "description": "When mode is 'Single player', the player's name (FIDE format 'Lastname, Firstname' or common format 'Firstname Lastname'). Ignored in 'Top players' mode."
          },
          "fideId": {
            "title": "FIDE ID (optional)",
            "type": "string",
            "description": "Alternative to player name when mode is 'Single player'. Most reliable lookup method - e.g. 1503014 for Magnus Carlsen."
          },
          "timeControl": {
            "title": "Time control",
            "enum": [
              "classical",
              "rapid",
              "blitz",
              "all"
            ],
            "type": "string",
            "description": "Primary time control for FIDE top list ranking. Chess.com and Lichess return all time controls regardless of this setting.",
            "default": "classical"
          },
          "filterByCountry": {
            "title": "Country filter",
            "type": "array",
            "description": "ISO3 country codes to filter by (e.g. NOR, USA, IND). Leave empty for all countries.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "filterByGender": {
            "title": "Gender filter",
            "enum": [
              "all",
              "men",
              "women"
            ],
            "type": "string",
            "description": "Filter by gender in FIDE data. 'All' returns both, 'Women' uses FIDE women's top lists, 'Men' uses open lists (which can include women).",
            "default": "all"
          },
          "includeChessCom": {
            "title": "Include Chess.com ratings",
            "type": "boolean",
            "description": "Fetch Chess.com ratings (bullet, blitz, rapid) and FIDE rating from Chess.com profile. Uses free public API.",
            "default": true
          },
          "includeLichess": {
            "title": "Include Lichess ratings",
            "type": "boolean",
            "description": "Fetch Lichess ratings (classical, rapid, blitz, bullet) and per-day rating history. Uses free public API.",
            "default": true
          },
          "include2700chess": {
            "title": "Include 2700chess live ratings",
            "type": "boolean",
            "description": "Fetch live classical ratings from 2700chess.com. Requires PlaywrightCrawler with residential proxy to bypass Cloudflare. Adds approximately 0.30 USD to run cost and 2 minutes runtime. Opt-in.",
            "default": false
          },
          "datasetId": {
            "title": "Target Dataset ID",
            "type": "string",
            "description": "Optional existing Apify dataset ID that receives a copy of every player row in addition to the default run dataset. Use it to combine scheduled rating snapshots or downstream workflow output. Format: Apify dataset ID such as aBcD1234efGh5678. Leave blank for normal runs."
          },
          "runId": {
            "title": "Parent Run ID",
            "type": "string",
            "description": "Optional parent Apify run ID copied into each output row as runId. Use it when this aggregator is one step in a larger workflow and rows must trace back to an upstream run. Format: Apify run ID such as aBcD1234efGh5678. Leave blank when no pipeline trace ID is needed."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Chess Ratings Aggregator | FIDE Chess.com Lichess OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Chess Ratings Aggregator from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Chess Ratings Aggregator API in Python

Chess Ratings Aggregator API in JavaScript

Chess Ratings Aggregator API through CLI

Chess Ratings Aggregator API

Chess.com Player & Game Scraper

parseforge/chess-com-scraper

Pull chess player profiles, game archives, titled player lists, country leaderboards, club memberships, and tournament data from the Chess.com public API. Rich stats, ratings, country, and PGN game data for any Chess.com username.

ParseForge

Chess.com

moving_beacon-owner1/chess-com

Chess.com Player Stats Scraper Scrapes Chess.com player stats including profile info, ratings, and W/L/D records (blitz, bullet, rapid, daily) using the public API. Outputs data to dataset.

Jamshaid Arif

chess-scraper

japan_fund/chess-scraper

rede ban

Lichess Chess Users Scraper

parseforge/lichess-chess-users-scraper

Scrape chess player profiles, ratings, and game stats from Lichess public API. Get user info, rating per variant, recent games, online status, tournament history. No API key required.

ParseForge

Chess.com Scraper

crawlerbros/chess-com-scraper

Scrape Chess.com - leaderboards, player profiles, stats, and game archives. Fully public API, zero credentials required.

Crawler Bros

Chess.com Player Profile & Rating Stats Scraper (Free)

fit_melon/chess-com-player-stats-scraper

Bulk scrape Chess.com player profiles and ratings: rapid, blitz, bullet and daily Elo, peak ratings, win/loss/draw records with win rate, title, country and followers. Free chess data export.

D N

Chess.com Player Scraper - Public Profile Data

benthepythondev/chess-com-player-scraper

Look up Chess.com players and export username, name, title, status, country, location, followers, dates, streamer and profile link.

Ben

FIDE Chess Ratings Scraper

parseforge/fide-chess-ratings-scraper

Unlock structured records from Fide Chess Ratings with names, identifiers, dates, descriptions, status flags and source links. Designed for research, intelligence and operational dashboards. Run on demand or on a recurring schedule and feed every row into your favourite analytics or workflow stack.

ParseForge

Chess Leaderboard Comparator (Lichess)

saint_person/lichess-leaderboard-comparator

Compare Lichess top-player leaderboards across time controls - top rating, title density, and rating spread, ranked side by side.

saint person

Chess Opponent Analyzer

trovevault/chess-opponent-analyzer

Analyzes a chess player's game history and opening repertoire from Lichess, Chess.com, or official tournaments. Extracts ECO statistics, opening trees, performance metrics, recent trends, and surprise detections. Export to PGN or JSON.