RunDida API

Free, open JSON endpoints for running data. No API key required. Perfect for running apps, AI agents, and developers building training tools.

Quick Start

All endpoints return JSON and require no authentication. Data is pre-generated at build time for maximum speed.

curl https://rundida.com/api/tools.json

Endpoints

Tools

Endpoint Description
/api/tools.json List of all 107 running tools with metadata
/api/tools/{slug}.json Full detail for a specific tool including FAQs, related tools, and sources

Marathons

Endpoint Description
/api/marathons.json All 184 active and archived marathon events
/api/marathons/{id}.json Full detail for a marathon including Schema.org SportsEvent data

Guides

Endpoint Description
/api/guides.json All 80 running guides with metadata

Calculations

For live calculations (pace, heart rate zones, race predictions, VO2max, splits, calories, distance conversion), use the MCP Server below. It performs all computations locally using established running science formulas.

Feeds

Endpoint Format
/feed.xml RSS 2.0 feed of all tools and guides
/feed.json JSON Feed 1.1 of all tools and guides
/llms.txt AI/LLM discovery protocol (plain text)

Examples

Data Endpoints

# List all tools
curl https://rundida.com/api/tools.json | jq '.tools[0]'

# Get pace calculator details
curl https://rundida.com/api/tools/pace-calculator.json | jq '.tool.faqs'

# Get upcoming marathons
curl https://rundida.com/api/marathons.json | jq '.active[0:5]'

Available Tool Slugs

Use these slugs with the /api/tools/{slug}.json endpoint:

hyrox-time-calculator

marathon-countdown

pace-calculator

pace-band-generator

race-morning-planner

heart-rate-zones

vo2max-calculator

finish-time-calculator

running-calories

race-time-predictor

splits-calculator

distance-converter

treadmill-pace

boston-qualifying

max-heart-rate

pace-speed-converter

age-grading

training-plan

race-day-checklist

what-to-wear

hydration-calculator

carb-loading

gel-calculator

taper-calculator

negative-split-planner

run-walk-planner

packing-list

training-pace

mileage-increase

training-start-date

race-equivalence

wall-predictor

heat-adjustment

cadence-calculator

interval-calculator

wind-effect

altitude-adjustment

weight-pace

weather-score

running-power

fitness-age

shoe-rotation

aqi-running

clothing-temp-guide

share-card

virtual-bib

mantra-generator

pr-prediction

recovery-planner

track-lane-distance

vdot-calculator

gap-calculator

running-economy

shoe-mileage

cross-training

lactate-threshold

running-cost

lottery-calculator

spectator-planner

running-streak

elevation-profile

running-log

steps-distance

social-post

treadmill-incline

injury-risk

training-load

return-to-running

sleep-recovery

running-bpm

gps-art

finisher-certificate

achievement-card

year-in-review

shoe-cost-mile

carbon-footprint

critical-velocity

cooper-test

electrolyte

pre-race-meal

aid-station

photo-timing

medal-tracker

interval-timer

uv-running

dew-point

marathon-finder

butter-run-calculator

hill-repeat-generator

hill-race-adjuster

course-difficulty-score

downhill-impact

hill-pacing-strategy

carbon-roi-calculator

shoe-match

running-quote-sticker

ice-cream-run-calculator

runner-bingo-card

hyrox-weights

hyrox-wall-ball-judge

race-weight

protein-calculator

hrv-calculator

gpx-viewer

yasso-800-calculator

norwegian-4x4-calculator

treadmill-pace-chart

Available Marathon IDs

spacecoast2026 — 2026 Space Coast Marathon - Nov 22

philadelphia2026 — 2026 Philadelphia Marathon - Nov 22

nanjing2026 — 2026 Nanjing Marathon - Nov 22

route662026 — 2026 Route 66 Marathon - Nov 22

tsukuba2026 — 2026 Tsukuba Marathon - Nov 22

sansebastian2026 — 2026 San Sebastián Marathon - Nov 22

fukuchiyama2026 — 2026 Fukuchiyama Marathon - Nov 22

otawara2026 — 2026 Otawara Marathon - Nov 23

bangkok2026 — 2026 Amazing Thailand Marathon Bangkok - Nov 29

seattle2026 — 2026 Seattle Marathon - Nov 29

florence2026 — 2026 Florence Marathon - Nov 29

turin2026 — 2026 Turin Marathon - Nov 29

larochelle2026 — 2026 La Rochelle Marathon - Nov 29

memphis2026 — 2026 St. Jude Memphis Marathon - Dec 5

jurassiccoast2026 — 2026 Jurassic Coast Marathon - Dec 5

whanganui2026 — 2026 Whanganui Marathon - Dec 6

shanghai2026 — 2026 Shanghai Marathon - Dec 6

shenzhen2026 — 2026 Shenzhen Marathon - Dec 6

cim2026 — 2026 California International Marathon - Dec 6

sanantonio2026 — 2026 San Antonio Marathon - Dec 6

kunming2026 — 2026 Kunming Marathon - Dec 6

valencia2026 — 2026 Valencia Marathon - Dec 6

naha2026 — 2026 Naha Marathon - Dec 6

shonan2026 — 2026 Shonan International Marathon - Dec 6

hofu2026 — 2026 Hofu Yomiuri Marathon - Dec 6

kiawah2026 — 2026 Kiawah Island Marathon - Dec 12

honolulu2026 — 2026 Honolulu Marathon - Dec 13

rocketcity2026 — 2026 Rocket City Marathon - Dec 13

msgulfcoast2026 — 2026 Mississippi Gulf Coast Marathon - Dec 13

tucson2026 — 2026 Tucson Marathon - Dec 13

dallas2026 — 2026 Dallas Marathon - Dec 13

aoshimataiheiyo2026 — 2026 Aoshima Taiheiyo Marathon - Dec 13

fujisan2026 — 2026 Mt. Fuji Marathon - Dec 13

nara2026 — 2026 Nara Marathon - Dec 13

taipei2026 — 2026 Taipei Marathon - Dec 20

guangzhou2026 — 2026 Guangzhou Marathon - Dec 20

portsmouthcoastal2026 — 2026 Portsmouth Coastal Marathon - Dec 20

miematsusaka2026 — 2026 Mie Matsusaka Marathon - Dec 20

hobart2027 — 2027 Hobart Marathon - Jan 3

lascruces2027 — 2027 State 47 Las Cruces Marathon - Jan 9

disneyworld2027 — 2027 Walt Disney World Marathon - Jan 10

xiamen2027 — 2027 Xiamen Marathon - Jan 10

chongqing2027 — 2027 Chongqing Marathon - Mar 21

ibusukinanohana2027 — 2027 Ibusuki Nanohana Marathon - Jan 10

carlsbad2027 — 2027 Carlsbad Marathon - Jan 17

houston2027 — 2027 Houston Marathon - Jan 17

louisiana2027 — 2027 Louisiana Marathon - Jan 17

ishigaki2027 — 2027 Ishigaki Island Marathon

miami2027 — 2027 Miami Marathon - Jan 31

katsuta2027 — 2027 Katsuta Marathon - Jan 31

surfcity2027 — 2027 Surf City Marathon - Feb 7

ehime2027 — 2027 Ehime Marathon - Feb 7

beppuoita2027 — 2027 Beppu-Oita Marathon

mesa2027 — 2027 Mesa Marathon - Feb 13

austin2027 — 2027 Austin Marathon - Feb 14

saitama2027 — 2027 Saitama Marathon - Feb 14

seville2027 — 2027 Seville Marathon - Feb 21

kyoto2027 — 2027 Kyoto Marathon - Feb 21

kitakyushu2027 — 2027 Kitakyushu Marathon - Feb 21

kochiryoma2027 — 2027 Kochi Ryoma Marathon - Feb 21

kumamotocastle2027 — 2027 Kumamoto Castle Marathon - Feb 21

cowtown2027 — 2027 Cowtown Marathon - Feb 28

osaka2027 — 2027 Osaka Marathon - Feb 28

myrtlebeach2027 — 2027 Myrtle Beach Marathon - Mar 6

sussexcoastal2027 — 2027 Sussex Coastal Marathon - Mar 6

newportnews2027 — 2027 Newport News One City Marathon - Mar 7

littlerock2027 — 2027 Little Rock Marathon - Mar 7

la2027 — 2027 LA Marathon - Mar 7

atlanta2027 — 2027 Atlanta Marathon - Mar 7

napavalley2027 — 2027 Napa Valley Marathon - Mar 7

kagoshima2027 — 2027 Kagoshima Marathon - Mar 7

meadows2027 — 2027 Meadows Marathon

tokyo2027 — 2027 Tokyo Marathon - Mar 7

tambasasayama2027 — 2027 Tamba-Sasayama ABC Marathon - Mar 7

tobaccoroad2027 — 2027 Tobacco Road Marathon - Mar 14

shizuoka2027 — 2027 Shizuoka Marathon - Mar 14

tokushima2027 — 2027 Tokushima Marathon

biwako2027 — 2027 Biwako Marathon - Mar 14

steyningstinger2027 — 2027 Steyning Stinger Marathon - Mar 14

barcelona2027 — 2027 Barcelona Marathon - Mar 14

rome2027 — 2027 Rome Marathon - Mar 14

tottori2027 — 2027 Tottori Marathon

nagoya2027 — 2027 Nagoya Women's Marathon - Mar 14

classiccity2027 — 2027 Classic City Marathon - Mar 20

seoul2027 — 2027 Seoul Marathon - Mar 21

shamrock2027 — 2027 Shamrock Marathon - Mar 21

ghent2027 — 2027 Ghent Marathon - Mar 21

itabashi2027 — 2027 Itabashi City Marathon

sagasakura2027 — 2027 Saga Sakura Marathon

kagawa2027 — 2027 Kagawa Marathon - Mar 21

wuxi2027 — 2027 Wuxi Marathon

fukuisakura2027 — 2027 Fukui Sakura Marathon - Mar 28

mtcharleston2027 — 2027 REVEL Mt Charleston Marathon - Apr 3

stlouis2027 — 2027 Greater St. Louis Marathon - Apr 3

milan2027 — 2027 Milan Marathon - Apr 4

paris2027 — 2027 Paris Marathon - Apr 4

brighton2027 — 2027 Brighton Marathon - Apr 4

bunbury2027 — 2027 Bunbury Marathon - Apr 11

coastaldelaware2027 — 2027 Coastal Delaware Marathon - Apr 11

southampton2027 — 2027 Southampton Marathon - Apr 11

bostonuk2027 — 2027 Boston Marathon UK - Apr 11

rotterdam2027 — 2027 NN Marathon Rotterdam - Apr 11

bonn2027 — 2027 Bonn Marathon - Apr 11

newcastlensw2027 — 2027 Newcastle Marathon - Apr 18

mountains2beach2027 — 2027 Mountains 2 Beach Marathon - Apr 18

christchurch2027 — 2027 Christchurch Marathon - Apr 18

jerseycity2027 — 2027 Jersey City Marathon - Apr 18

ballarat2027 — 2027 Ballarat Marathon - Apr 18

manchester2027 — 2027 Manchester Marathon - Apr 18

newport2027 — 2027 Newport Wales Marathon - Apr 18

guernsey2027 — 2027 Guernsey Marathon - Apr 18

kentspring2027 — 2027 Kent Spring Marathon - Apr 18

krakow2027 — 2027 Cracovia Marathon - Apr 18

vienna2027 — 2027 Vienna City Marathon - Apr 18

kasumigaura2027 — 2027 Kasumigaura Marathon - Apr 18

boston2027 — 2027 Boston Marathon - Apr 19

olathe2027 — 2027 Garmin Olathe Marathon - Apr 24

kentuckyderby2027 — 2027 Kentucky Derby Festival Marathon - Apr 24

saltlakecity2027 — 2027 Salt Lake City Marathon - Apr 24

nashville2027 — 2027 Rock 'n' Roll Nashville Marathon - Apr 24

pembrokeshire2027 — 2027 Endurancelife Pembrokeshire Marathon - Apr 24

maui2027 — 2027 Maui Marathon - Apr 25

glasscity2027 — 2027 Glass City Marathon - Apr 25

oklahomacity2027 — 2027 Oklahoma City Memorial Marathon - Apr 25

bigsur2027 — 2027 Big Sur International Marathon - Apr 25

eugene2027 — 2027 Eugene Marathon - Apr 25

mississauga2027 — 2027 Mississauga Marathon - Apr 25

hamburg2027 — 2027 Hamburg Marathon - Apr 25

madrid2027 — 2027 Madrid Marathon - Apr 25

blackpool2027 — 2027 Blackpool Marathon - Apr 25

shakespeare2027 — 2027 Shakespeare Marathon - Apr 25

london2027 — 2027 TCS London Marathon - Apr 25

rotorua2027 — 2027 Rotorua Marathon - May 1

ocmarathon2027 — 2027 OC Marathon - May 2

flyingpig2027 — 2027 Flying Pig Marathon - May 2

fortcollins2027 — 2027 Colorado Marathon - May 2

pittsburgh2027 — 2027 Pittsburgh Marathon - May 2

lincoln2027 — 2027 Lincoln Marathon - May 2

eauclaire2027 — 2027 Eau Claire Marathon - May 2

torontospring2027 — 2027 Toronto Marathon (Spring) - May 2

avenueofthegiants2027 — 2027 Avenue of the Giants Marathon - May 2

vancouver2027 — 2027 Vancouver Marathon - May 2

belfast2027 — 2027 Belfast City Marathon - May 2

newcastle2027 — 2027 Newcastle-Gateshead Marathon - May 2

threeforts2027 — 2027 Three Forts Marathon - May 2

miltonkeynes2027 — 2027 Milton Keynes Marathon - May 3

fredericton2027 — 2027 Fredericton Marathon - May 9

leeds2027 — 2027 Leeds Marathon - May 9

halstead2027 — 2027 Halstead & Essex Marathon - May 9

ogden2027 — 2027 Ogden Marathon - May 15

hawkesbay2027 — 2027 Napier Marathon - May 15

whitepeak2027 — 2027 White Peak Marathon - May 15

denver2027 — 2027 Denver Colfax Marathon - May 16

cleveland2027 — 2027 Cleveland Marathon - May 16

sugarloaf2027 — 2027 Sugarloaf Marathon - May 16

reddeer2027 — 2027 Red Deer Marathon - May 16

worcester2027 — 2027 Worcester Marathon - May 16

noosa2027 — 2027 Noosa Heads Marathon - May 22

fargo2027 — 2027 Fargo Marathon - May 22

capetown2027 — 2027 Cape Town Marathon - May 23

bluenose2027 — 2027 Blue Nose Marathon - May 23

bayshore2027 — 2027 Bayshore Marathon - May 29

stockholm2027 — 2027 Stockholm Marathon - May 29

buffalo2027 — 2027 Buffalo Marathon - May 30

ottawa2027 — 2027 Ottawa Marathon - May 30

vermontcity2027 — 2027 Vermont City Marathon - May 30

edinburgh2027 — 2027 Edinburgh Marathon - May 30

brisbane2027 — 2027 Brisbane Marathon - Jun 6

deadwood2027 — 2027 Deadwood-Mickelson Trail Marathon - Jun 6

coniston2027 — 2027 Lakeland Trails Coniston Marathon - Jun 6

goldcoast2027 — 2027 Gold Coast Marathon - Jul 4

sunshinecoast2027 — 2027 Sunshine Coast Marathon - Aug 1

sydney2027 — 2027 TCS Sydney Marathon - Aug 29

brightonbeach2027 — 2027 Brighton Beach Marathon - Sep 5

kauai2027 — 2027 Kauai Marathon - Sep 5

geelong2027 — 2027 Geelong Marathon - Sep 19

berlin2027 — 2027 Berlin Marathon - Sep 26

lochness2027 — 2027 Loch Ness Marathon - Sep 26

chicago2027 — 2027 Chicago Marathon - Oct 10

greatwelsh2027 — 2027 Great Welsh Marathon - Oct 17

auckland2027 — 2027 Auckland Marathon - Oct 31

newyork2027 — 2027 NYC Marathon - Nov 7

chibaaqualine2026 — 2026 Chiba Aqua-Line Marathon - Postponed to Nov 21, 2027

norfolk2027 — 2027 Norfolk Marathon - Nov 21

OpenAPI Specification

Machine-readable API documentation in OpenAPI 3.0 format:

https://rundida.com/api/openapi.json

MCP Server for AI Agents

RunDida provides an MCP (Model Context Protocol) server for direct AI agent integration:

# Install
npm install @rundida/mcp-server

# Add to Claude Desktop config
{
  "mcpServers": {
    "rundida": {
      "command": "npx",
      "args": ["@rundida/mcp-server"]
    }
  }
}

Available MCP tools:

  • list_tools — browse all 107 running calculators
  • get_tool — get details for a specific tool
  • list_marathons — list all marathon events
  • get_marathon — get marathon details and countdown
  • calculate_pace — pace/time/distance calculations
  • predict_race — predict finish times from a known result
  • heart_rate_zones — calculate training HR zones
  • marathon_countdown — days until a specific marathon

For AI Agents

If you're building an AI agent that needs running data:

  • Start with /llms.txt for a machine-readable overview of all available resources
  • Use the MCP server above for direct tool integration with Claude and other MCP-compatible agents
  • Use /api/tools.json to discover available calculators
  • Use /api/marathons.json for race event data
  • Use /api/openapi.json for the OpenAPI specification
  • All pages include Schema.org structured data (WebApplication, FAQPage, SportsEvent)

Terms of Use

  • Free for personal and commercial use
  • No API key required
  • Please include attribution when displaying RunDida data
  • Data is regenerated at each site build — cache responses for at least 1 hour
  • For high-volume usage, please reach out on GitHub