Mararun China Marathon Event Platform Scraper
Pricing
Pay per event
Mararun China Marathon Event Platform Scraper
Scrapes the Mararun platform — the dominant Chinese marathon management SaaS. Returns event details for mararun-hosted Chinese marathons: name, date, city, registration windows, participant cap, organizer, and CAA/AIMS certification.
Pricing
Pay per event
Rating
0.0
(0)
Developer
BowTiedRaccoon
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
6 days ago
Last modified
Share
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
- No proxy required — the
saas-user-gw.mararun.comAPI is fully open (no auth, no Cloudflare). - Discovery limitation — the platform's global organizer catalog (
cloud-gateway.mararun.com) requires OAuth. New events on the platform must be added to theKNOWN_HOST_KEYSlist 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 uses5000as a sentinel value for "many results". The actor usespageSize=200, which covers all known event histories in a single call.
