olympics.com APIolympics.com ↗
Access Olympic Games editions, medal tables, athlete profiles, discipline lists, and event results from olympics.com via 7 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/6370143b-626a-4292-afab-80c2c2caa166/list_olympic_games' \ -H 'X-API-Key: $PARSE_API_KEY'
List all Olympic Games editions (past, current, and upcoming) with their details including season, year, title, slug, and categorization by type (Summer, Winter, Youth).
No input parameters required.
{
"type": "object",
"fields": {
"header": "object with lastUpdate timestamp",
"modules": "array of content modules including games list with type identifiers"
},
"sample": {
"data": {
"header": {
"id": "",
"version": "",
"lastUpdate": "2026-05-07T13:48:52.549Z"
},
"modules": [
{
"type": "olympicEditionsDropdownVocTags",
"content": {
"explore-explore": {
"translation": "Explore",
"abbreviation": "Explore"
},
"tab-summer-olympic-games": {
"translation": "Olympic Games",
"abbreviation": "tag-abbr:tab-summer-olympic-games"
}
},
"moduleName": "Module_848ab1ef90a44e5b94d7ca319813c1ab"
},
{
"type": "olympicEditionsDropdownCarousel",
"content": [
{
"url": "https://www.olympics.com/en/olympic-games/utah-2034/",
"slug": "utah-2034",
"year": "2034",
"title": "Utah 2034",
"season": "Winter"
}
],
"moduleName": "Module_f89a86ba19084f9486c2f46483af8a3e"
}
]
},
"status": "success"
}
}About the olympics.com API
This API surfaces 7 endpoints covering the full breadth of official Olympic data from olympics.com — past games editions, per-discipline event results, country medal tables, and individual athlete profiles. The get_medal_table endpoint returns gold, silver, and bronze counts for every nation that medaled in a given games edition, while get_athlete_profile delivers career-level stats including total medal counts, biographical text, disciplines, and full Olympic results history.
Games, Disciplines, and Events
list_olympic_games returns all editions — Summer, Winter, and Youth — with each entry including a season, year, title, and slug. Those slugs (e.g. paris-2024, beijing-2022) are the primary key for all other endpoints. list_disciplines accepts a games_slug and returns the array of sports contested at that edition, each with a slug, title, and sport_discipline_id. This endpoint only works for completed games that have medal data; passing a future games slug returns an upstream error. list_events narrows further by accepting both a games_slug and a discipline_slug, returning every individual event with its slug, title, and gender category.
Results and Medal Tables
get_event_results takes the same games_slug + discipline_slug pair and returns results for every event in that discipline in one call. Each entry in the events array includes an awards array identifying gold, silver, and bronze medalists by medal_type, rank, and athlete_name. get_medal_table accepts a games_slug and returns the full country standings — country, country_code, gold, silver, bronze, total — for every nation that appeared on the podium, along with a total_countries count.
Athlete Data
search_featured_athletes returns a curated list of notable athletes currently highlighted on olympics.com, each with name, slug, country, country_code, discipline, and a thumbnail URL. Those slugs feed directly into get_athlete_profile, which returns a richer record: biography, quote, career medals broken down by GOLD/SILVER/BRONZE, the athlete's disciplines array (with ODF codes), gender, and an image_url template. Olympic results history with placements is also included in the profile response.
- Build a historical medal-count dashboard comparing nations across multiple games editions using
get_medal_table. - Populate an athlete directory with career stats, bios, and discipline affiliations from
get_athlete_profile. - Track which countries dominated specific disciplines (e.g. swimming, athletics) by cross-referencing
get_event_resultswithget_medal_table. - Generate a sport-by-sport breakdown of all events and gender categories for a given games using
list_events. - Create a game-edition browser listing all Summer, Winter, and Youth Olympics with year and slug from
list_olympic_games. - Power a sports trivia app with gold/silver/bronze medalist names per event from
get_event_results. - Surface featured athlete cards with thumbnails, country flags, and discipline tags using
search_featured_athletes.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does olympics.com have an official developer API?+
What does `get_event_results` return, and how granular is the medal data?+
get_event_results returns results for all events within one discipline at a completed games in a single call. Each event object includes an awards array where each entry specifies medal_type (gold, silver, bronze), rank, and athlete_name. Team events include country affiliation. The total_events field tells you how many events had results available.Can I retrieve results for upcoming or in-progress Olympic Games?+
list_disciplines, list_events, get_event_results, and get_medal_table all require a completed games slug. Passing a slug for a future or ongoing games that lacks finalized medal data returns an upstream error. The data scope is limited to editions where official results exist.Does the API return full Olympic schedule or heat-level results, not just medal winners?+
Can I look up any athlete by name, or only the ones in `search_featured_athletes`?+
search_featured_athletes returns a curated set of highlighted athletes and is the primary way to discover athlete slugs. get_athlete_profile then accepts any valid slug (e.g. usain-bolt, simone-biles). If you need to search athletes outside the featured list, the current API does not expose a general athlete search endpoint. You can fork this API on Parse and revise it to add a broader athlete search capability.