FIDE APIcalendar.fide.com ↗
Search and retrieve FIDE chess tournament listings. Filter by country, time control, date range, and event type. Get full event details including prize fund and venue.
What is the FIDE API?
The FIDE Calendar API provides 2 endpoints to search and retrieve structured data from the official FIDE tournament calendar at calendar.fide.com. The search_tournaments endpoint returns paginated lists of upcoming and ongoing events filtered by country, continent, time control, event type, and date range, while get_tournament_details delivers full per-event data across more than 12 fields including prize fund, venue, tournament system, and online/in-person status.
curl -X GET 'https://api.parse.bot/scraper/062af7e1-8e35-46bb-9eab-0fcbc3e430ea/search_tournaments?to_date=2026-12-20&continent=all&from_date=2026-08-22&event_type=all&time_control=all' \ -H 'X-API-Key: $PARSE_API_KEY'
Search ongoing and upcoming chess tournaments from the FIDE calendar with filters for time control, event type, continent, country, and date range. Returns paginated results with 15 tournaments per page. Each result includes an event_id that can be used with get_tournament_details for full information including prize fund, tournament system, and venue details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (15 results per page). |
| search | string | Free-text search filter for tournament name. |
| country | string | Filter by country code (3-letter ISO code, e.g. 'usa', 'ger', 'esp'). Omitted or 'all' returns all countries. |
| to_date | string | End of date range in ISO format YYYY-MM-DD. Defaults to 120 days from today when omitted. |
| continent | string | Filter by continent/region. Omitted or 'all' returns all locations. |
| from_date | string | Start of date range in ISO format YYYY-MM-DD. Defaults to today's date when omitted. |
| event_type | string | Filter by event type (in-person, online, hybrid). Omitted or 'all' returns all types. |
| time_control | string | Filter by time control format. Omitted or 'all' returns all time controls. |
{
"type": "object",
"fields": {
"page": "current page number",
"total_pages": "total number of available pages",
"tournaments": "array of tournament summary objects with name, event_id, date_range, location, time_control, country_code, and optional category"
},
"sample": {
"page": 1,
"total_pages": 12,
"tournaments": [
{
"name": "Saint Louis Rapid",
"category": "FIDE Circuit",
"event_id": "10674",
"location": "Saint Louis, Missouri, USA",
"date_range": "29 Jul - 28 Aug",
"country_code": "USA",
"time_control": "Rapid"
},
{
"name": "OBERBANK-CHALLENGER-OPEN 2026",
"event_id": "13299",
"location": "Linz, AUT",
"date_range": "15 - 23 Aug",
"country_code": "AUT",
"time_control": "Standard"
}
]
}
}About the FIDE API
Search and Filter Tournaments
The search_tournaments endpoint returns up to 15 results per page and accepts a range of optional filters: time_control, event_type (in-person, online, hybrid), continent, country (3-letter ISO code such as usa, ger, or esp), and a date window defined by from_date and to_date in YYYY-MM-DD format. When date params are omitted, the endpoint defaults to today through 120 days out. A free-text search param filters by tournament name. Each result in the tournaments array includes name, event_id, date_range, location, time_control, country_code, and an optional category field.
Full Tournament Details
Passing an event_id returned by search_tournaments to get_tournament_details retrieves the complete event record. Response fields cover name, city, country, venue, address, website, end_date, is_online (boolean), event_type (Over-the-Board Tournament, Online, Hybrid, or Meeting), and event_id. Prize fund, tournament system (Swiss or Round-Robin), and any related event association are also included where the source provides them.
Pagination and Coverage
Results from search_tournaments are paginated; the response includes page (current page) and total_pages so callers can iterate through the full result set. The calendar covers FIDE-registered events globally — from large open tournaments to federation meetings — and is updated as new events are submitted to the FIDE calendar.
The FIDE API is a managed, monitored endpoint for calendar.fide.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when calendar.fide.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official calendar.fide.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a tournament finder app that lets players filter FIDE events by country code and time control format.
- Aggregate prize fund data across upcoming open tournaments to identify high-value events in a given date range.
- Track online vs. in-person event ratios over time using the
is_onlineandevent_typefields. - Populate a chess club newsletter with automatically fetched local tournament listings filtered by continent or country.
- Monitor new FIDE-rated events for a specific region by polling
search_tournamentswithfrom_dateandto_dateparameters. - Display venue maps by extracting
city,country,venue, andaddressfields fromget_tournament_details. - Compare tournament systems (Swiss vs. Round-Robin) across events in a season using the tournament system field.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FIDE provide an official public developer API for the tournament calendar?+
What does `get_tournament_details` return beyond what `search_tournaments` shows?+
search_tournaments returns a summary: name, event_id, date_range, location, time_control, country_code, and optional category. get_tournament_details adds venue, address, website, end_date, is_online, event_type, prize fund, tournament system, and related event information — fields not present in the list results.How far ahead does the date range cover, and can I search past tournaments?+
from_date and to_date are omitted, search_tournaments defaults to today through 120 days out. The FIDE calendar is focused on ongoing and upcoming events; historical tournament archives are not exposed by either endpoint.Does the API return player registration lists or individual game results for tournaments?+
Is there a way to retrieve all tournaments without filtering by continent or country at once?+
continent and country params (or passing 'all') returns results across all regions. Use the page parameter and iterate through total_pages to retrieve the full unfiltered result set 15 records at a time.