# FIDE Chess Ratings Scraper (`acquistion-automation/fide-chess-ratings-scraper`) Actor

Scrapes the official FIDE Top 100 players lists for Open, Women, Juniors, and Girls. Returns each player's rank, name, title, federation, rating, and birth year as a flat row.

- **URL**: https://apify.com/acquistion-automation/fide-chess-ratings-scraper.md
- **Developed by:** [Acquisition Automation Co.](https://apify.com/acquistion-automation) (community)
- **Categories:** Other, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

![Acquisition Automation Co. Search less. Close more.](https://api.apify.com/v2/key-value-stores/AOdPHdOpeDpzEPS5f/records/banner.jpg)

## ♟ FIDE Chess Ratings Scraper

> **Export a FIDE Top 100 list as rows: rank, name, rating, federation, birth year and FIDE ID.** Choose the Open, Women, Juniors or Girls list and the Actor returns each player with a link to their FIDE profile. No API key, no registration.

FIDE publishes the official world rankings at `ratings.fide.com`. The lists are rendered as a web table, refreshed on FIDE's own schedule, and there is no download button. If you keep a rating history, run a scouting sheet, or publish a top ten widget, you end up copying the same table every month. This Actor reads the list you pick and writes it into a dataset you can append to.

| Who uses it | What they use the lists for |
|---|---|
| 🎯 Coaches and scouts | Tracking rating movement on the Juniors and Girls lists month over month |
| 📰 Chess journalists and site owners | Keeping a published top ten in step with the official list |
| 📊 Analysts and researchers | Building a rating history to study federation strength or rating inflation |
| 🏆 Tournament organisers | Checking rating and federation before sending invitations |

### 📋 What it does

> 💡 **Why it matters:** a rating table is only useful over time. One run a month, appended, is a rating history nobody has to type.

- 📑 **Four official lists.** `open`, `women`, `juniors` and `girls`, selected with one input.
- 🔢 **Rank and rating as numbers**, so sorting and differencing work without cleaning.
- 🌍 **Federation code** for each player, for example `NOR` or `USA`, with the flag image URL alongside.
- 🎂 **Birth year** as FIDE records it, which is what the age category lists are built on.
- 🆔 **FIDE ID and profile link**, the stable key for joining runs together or looking a player up.
- 📦 **One row per player**, the same 11 fields every run, exportable as CSV, Excel, JSON or XML.

### 📊 Output

Every player is one flat row.

| Field | Type | Description |
|---|---|---|
| 🥇 `rank` | integer | Position on the chosen list, starting at 1 |
| 👤 `name` | string | Player name as FIDE writes it, surname first |
| 🌍 `federation` | string | Three letter federation code, for example `NOR` |
| 🚩 `federationFlag` | string | URL of the federation flag image on `ratings.fide.com` |
| 📈 `rating` | integer | Standard FIDE rating on the published list |
| 🎂 `birthYear` | integer | Year of birth as recorded by FIDE |
| 🆔 `fideId` | string | FIDE player ID, stable across lists and runs |
| 📑 `list` | string | Which list the row came from: `open`, `women`, `juniors` or `girls` |
| 🔗 `sourceUrl` | string | The player's FIDE profile page |
| 🕒 `scrapedAt` | string | ISO timestamp of collection |
| ⚠️ `error` | string | `null` on a normal row |

#### Example rows

```json
{
  "rank": 1,
  "name": "Carlsen, Magnus",
  "federation": "NOR",
  "federationFlag": "https://ratings.fide.com/images/flags/no.svg",
  "rating": 2823,
  "birthYear": 1990,
  "fideId": "1503014",
  "list": "open",
  "sourceUrl": "https://ratings.fide.com/profile/1503014",
  "scrapedAt": "2026-09-14T17:21:52.996Z",
  "error": null
}
```

```json
{
  "rank": 2,
  "name": "Nakamura, Hikaru",
  "federation": "USA",
  "federationFlag": "https://ratings.fide.com/images/flags/us.svg",
  "rating": 2792,
  "birthYear": 1987,
  "fideId": "2016192",
  "list": "open",
  "sourceUrl": "https://ratings.fide.com/profile/2016192",
  "scrapedAt": "2026-09-14T17:21:53.121Z",
  "error": null
}
```

### ✨ Why choose this Actor

| | What you get |
|---|---|
| **The official source** | Rows come from FIDE's own ratings site, not from a mirror or a chess platform's own rating. |
| **A join key on every row** | `fideId` lets you match this month's list against last month's without matching on names. |
| **The list is labelled** | `list` travels with the row, so four runs append into one table that still makes sense. |
| **No credentials** | The rankings are public. No API key, no account. |
| **You pay per row** | A full Top 100 list is 100 rows. All four lists is 400. |

### 🚀 How to use it

1. [Create a free Apify account](https://console.apify.com/sign-up). New accounts start with $5 of credit.
2. Open the Actor and select **Try for free**.
3. Set `list` to `open`, `women`, `juniors` or `girls`.
4. Set `maxItems` to cap the run. Each list holds 100 players, so 100 collects the whole thing.
5. Select **Start**, then export from the **Dataset** tab as CSV, Excel, JSON or XML.

A first run:

```json
{
  "list": "open",
  "maxItems": 10
}
```

A full list:

```json
{
  "list": "juniors",
  "maxItems": 100
}
```

### ⚙️ Input

| Field | Required | Description |
|---|---|---|
| `list` | No | Which FIDE Top 100 list to read: `open`, `women`, `juniors` or `girls`. Defaults to `open` |
| `maxItems` | No | Maximum players to collect in a run |

### 💰 Pricing

Pay per result. No subscription, and no Apify platform usage on top.

| Apify plan | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Per player row | $0.021 | $0.0203 | $0.0197 | $0.019 | $0.019 | $0.019 |

| Rows collected | Cost on the Free plan |
|---|---|
| 10 | $0.21 |
| 100, a full list | $2.10 |
| 400, all four lists | $8.40 |

**Free plan runs** return up to 10 rows as a preview. Any paid Apify plan lifts that cap.

### 🔌 Integrate with any app

The dataset is available through the Apify API as soon as the run finishes. Use `run-sync-get-dataset-items` for a one-shot call, webhooks to trigger what happens next, or the Make, Zapier, Airbyte and LangChain integrations listed on the Actor page. Put the Actor on a monthly schedule and the rating history builds itself.

### 🤖 Use with an AI agent

Give an agent live access to the FIDE rankings over the Model Context Protocol:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=acquistion-automation/fide-chess-ratings-scraper"
```

Then ask it in plain language for the current top ten and read the rows back.

### ❓ Frequently asked questions

**Does it return the player's title, such as GM or IM?**
No. The output carries rank, name, federation, flag URL, rating, birth year, FIDE ID and profile link. Titles are on the FIDE profile page, which this Actor does not open.

**Can I look up one player by name or ID?**
No. The Actor reads a Top 100 list from the top down. A player outside the top 100 of the list you choose will not appear.

**Why did I get fewer rows than `maxItems`?**
Each list holds 100 players. Setting `maxItems` above 100 returns the 100 that exist.

**Is this blitz and rapid too?**
No. These are the standard rating lists FIDE publishes as Top 100.

**Player names have unusual characters. Is that an error?**
No. Names are saved exactly as FIDE writes them. Open the CSV as UTF-8 and they render correctly.

**What can I export?**
CSV, Excel, JSON and XML from the run page, or JSON straight from the API.

### 🔗 More from Acquisition Automation Co.

- [Bundesliga Stats Scraper](https://apify.com/acquistion-automation/bundesliga-stats-scraper)
- [RAWG Scraper](https://apify.com/acquistion-automation/rawg-scraper)
- [Mojang Minecraft Profile Scraper](https://apify.com/acquistion-automation/mojang-minecraft-profile-scraper)
- [Tunefind Soundtracks Scraper](https://apify.com/acquistion-automation/tunefind-soundtracks-scraper)
- [DANE Colombia Statistics Scraper](https://apify.com/acquistion-automation/dane-colombia-statistics-scraper)

### About Acquisition Automation Co.

We build automation for people buying businesses. The repetitive part of an acquisition search, checking listings, pulling public records, tracking owners and assets, is work a machine should do, so the buyer's time goes into judging deals instead of collecting them.

We add new Actors regularly. If there is a source you need and do not see here, tell us.

### 🆘 Support

Open an issue in the **Issues** tab of this Actor with your run ID, the input you used, and what you expected to get back.

### ⚠️ Disclaimer

This Actor is independent and is not affiliated with, endorsed by, or sponsored by FIDE, the International Chess Federation. It collects only publicly available data. You are responsible for using that data in compliance with the source's terms of service and applicable law.

# Actor input Schema

## `list` (type: `string`):

Which FIDE Top 100 list to scrape.

## `maxItems` (type: `integer`):

How many players to collect per run.

## Actor input object example

```json
{
  "list": "open",
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("acquistion-automation/fide-chess-ratings-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("acquistion-automation/fide-chess-ratings-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 10
}' |
apify call acquistion-automation/fide-chess-ratings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,acquistion-automation/fide-chess-ratings-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/B2tLsmJlHageqRdSV/builds/JuzOoo1jYjugPF5b3/openapi.json