Mararun China Marathon Event Platform Scraper

Scrapes the Mararun platform (saas-user-gw.mararun.com) — the dominant Chinese marathon management SaaS used by major CAA-labeled and regional road races across China. Returns structured event data for all event editions hosted on the platform: name (Chinese + English), race date, city, province, registration windows, participant cap, organizer, CAA label (gold/silver/bronze), and AIMS certification status.

What it does

Mararun hosts dedicated sub-platforms for each race organizer, keyed by a hostKey slug (e.g. beijing-host, guangzhou-host). The platform's gateway API at saas-user-gw.mararun.com/v1/match/lists is publicly accessible without authentication. This actor calls the API for each known organizer and normalises the response into a flat dataset.

The actor ships with 13 verified hostKeys covering the major CAA-labeled marathons and prominent regional events:

City	Event	Notes
Beijing	Beijing Marathon	Oldest on platform; multiple editions
Guangzhou	Guangzhou Marathon	CAA Gold Label
Wuhan	Wuhan Marathon
Nanjing	Nanjing Marathon
Tianjin	Tianjin Marathon
Kunming	Kunming Marathon	SCO-branded
Nanchang	Nanchang Marathon
Xi'an	Xi'an City Wall Half Marathon
Nanning	Nanning Marathon	Southern China
Haikou	Haikou Beach Marathon
Yangzhou	Yangzhou Half Marathon	Bank of China flagship half
Xuzhou	Xuzhou Marathon
Huai'an	Huai'an Marathon

Output schema

Each record represents one event edition (a single race year/season):

Field	Type	Description
event_id	string	Mararun internal match ID
event_subdomain	string	Organizer hostKey (e.g. beijing-host)
event_name_zh	string	Official event name in Chinese
event_name_en	string	Official event name in English
event_date	string	Race day (ISO-8601)
event_city	string	Host city (Chinese)
event_province	string	Host province / region
event_type	string	marathon, trail, or fun-run
participant_cap	integer	Maximum participant count
registration_fee_cny	number	Base registration fee in CNY
registration_open_date	string	Registration opening date (ISO-8601)
registration_close_date	string	Registration close date (ISO-8601)
organizer	string	Event organizer / host committee
caa_label	string	CAA label: gold, silver, bronze, or empty
aims_certified	boolean	Whether the course is AIMS-certified
is_active	boolean	Whether the event is currently open/upcoming
results_count	integer	Finisher results hosted on the platform
event_url	string	Event registration page URL
history_count	integer	Number of past editions for this event series
mkey	string	Mararun edition key (e.g. beijing-2024)
scrapedAt	string	ISO-8601 scrape timestamp

Input

Parameter	Type	Default	Description
maxItems	integer	10	Maximum number of event editions to return (across all organizers). Leave blank for all.

Usage notes

• Discovery limitation — the platform's global organizer catalog (cloud-gateway.mararun.com) requires OAuth. New events on the platform must be added to the KNOWN_HOST_KEYS list in the actor source.
• distances_offered — the list endpoint does not expose individual distance categories; fetching per-edition detail pages would require an additional API call per event. This field is left empty in the current version.
• total: 5000 — Mararun's API uses 5000 as a sentinel value for "many results". The actor uses pageSize=200, which covers all known event histories in a single call.