Olympics Athletes, Medals and Results

Collect structured Olympic data from the public pages of Olympedia: athlete profiles with every Games they entered, medal tables per Games, full event result lists, country medal histories and the list of all Games. Data comes from Olympedia, a volunteer-run reference site; this Actor is an independent tool and has no affiliation with it. Please credit Olympedia when you publish results.

What you can do

Mode	One output row is...	Typical input
athlete	one athlete, with bio, participations and medals	athlete ids or URLs
edition-medal-table	one country in the medal table of one Games	Summer 2024, Winter 2022, edition ids
event-results	one competitor or team in one event	result ids/URLs, or Games + sports
country-medals	one country, with medals per Games and best sports	NOC codes such as USA
editions	one Games (year, season, city, dates, size)	none (optional filters)

All modes honor maxItems. If an input cannot be processed (unknown id, page missing) the Actor adds an error row ("error": true, with a message) and keeps going. Error rows do not count toward maxItems.

Examples

Athlete profiles:

{ "mode": "athlete", "athleteIds": ["128460", "https://www.olympedia.org/athletes/137711"], "includeBiography": true, "maxItems": 10 }

Medal tables:

{ "mode": "edition-medal-table", "editions": ["Summer 2024", "Winter 2022"], "maxItems": 100 }

Event results, by result id or by Games + sport:

{ "mode": "event-results", "resultIds": ["19019500"], "maxItems": 100 }

{ "mode": "event-results", "resultIds": [], "editions": ["Winter 2022"], "sports": ["CUR"], "maxItems": 200 }

Country medals:

{ "mode": "country-medals", "countries": ["USA", "NOR"], "maxItems": 5 }

List of Games:

{ "mode": "editions", "season": "Winter", "includeDetails": true, "maxItems": 30 }

Input

Field	Used by	Description
mode	all	One of the five modes above.
athleteIds	athlete	Athlete ids or /athletes/ URLs.
includeBiography	athlete	Add the written biography when the page has one.
editions	medal table, event results, editions	Summer 2024, Winter 2022, 2024 (if unambiguous), an edition id, or a URL. For editions it is an optional filter.
resultIds	event-results	Result ids or /results/ URLs.
sports	event-results	Sport codes or names; adds all events of those sports in the chosen Games.
countries	country-medals	NOC codes or country URLs.
season, includeDetails, includeOtherGames	editions	Season filter, fetch athlete/event counts, include youth and intercalated Games.
maxItems	all	Maximum number of result rows.
concurrency	all	1 or 2 parallel workers (hard cap 2).
proxyConfiguration	all	Optional; usually not needed.

Output fields

Athlete mode:

Field	Meaning
athleteId, name, fullName, usedName, nickNames	identity
sex, roles	sex and roles (competitor, administrator, ...)
bornDate, bornDateIso, bornPlace, diedDate, diedDateIso, diedPlace, diedAge	life dates; the ISO field is set only for complete dates
heightCm, weightKg	measurements when listed
nationality, noc, allNocs	main country name and code; all codes if several
affiliations	clubs and similar
participations[]	edition, editionId, year, season, sport, sportCode, noc, event, resultId, eventStatus, result (position or status such as DNF), medal
medals	gold, silver, bronze, total as shown on the athlete page
sports, editionsCompeted, firstYear, lastYear, biography, url	derived summary

Edition medal table: edition, editionId, year, season, rank, country, noc, gold, silver, bronze, total, url.

Event results: resultId, event, edition, editionId, year, season, sport, sportCode, date, eventStatus, location, position, positionNumber, entryType (athlete or team), athleteId, athleteName, teamName, noc, result, medal, details (all extra columns such as time, points, distance), members (team roster), url.

Country medals: noc, country, olympicGamesParticipations, totalGold, totalSilver, totalBronze, totalMedals, bestEdition, medalsByEdition[], bestSports[] (top 10), medalsBySport[], url.

Editions: editionId, name, competitionType, number, year, season, city, hostCountryNoc, openingDate, closingDate, competitionDates, held, note, athletes, countries, medalEvents, disciplines, url.

Notes and limitations

• Only public pages are read. Requests are spaced by a random 0.8 to 1.8 seconds, at most 2 run at once, and 429/5xx answers are retried with growing waits. Large runs therefore take time; this is intentional.
• Medal tables come from the Games overview page. Olympedia assigns medals by its own rules, so numbers can differ slightly from other sources (for example around stripped medals or mixed teams).
• In event-results only the first (final standings) table of a result page is read; heats, rounds and individual matches are not output. For team sports, result is the best matching stats column and the rest is in details.
• Some pages have partial data: missing birth places, no measurements, dates with only a year, positions given as status codes. These come through as null or raw text.
• country-medals totals count Olympic Games only (not Youth or Intercalated); medalsByEdition lists every competition type with a competitionType field.
• A Summer/Winter word is required for editions text when a bare year is shared by both seasons (1924 to 1992).
• Page layout may change on the source site, which could affect parsing.

Running locally

npm install
./run-test.sh '{"mode":"editions","maxItems":3}'

run-test.sh sets CRAWLEE_STORAGE_DIR=./storage, writes the input to local storage and prints the dataset rows. No account or token is needed.