For developers

Developer overview

What you can build against Run This today: a production API for timing companies, and machine-readable mirrors of every public page.

The Timer API

If you build timing software, this is the integration. It's a production, key-authenticated REST API scoped to the events your company is assigned to time. It covers live rosters with delta sync so you can poll cheaply, bib write-back, results upload, CSV feeds, and webhooks with signature verification. Full reference at the Timer API docs.

Access follows from being a verified timing company on Run This. You get an API key from your company dashboard once a director assigns you to an event. Start at getting set up as a timer.

Machine-readable pages

Every public page has a plain-text twin. Append .md to the URL and you get clean Markdown instead of HTML, with no scraping and no parsing around markup:

runthis.run/event/your-race.mdfor an event's details, distances, and dates.
runthis.run/club/your-club.md and /community/your-area.md
runthis.run/articles/some-post.md
Race-calendar pages by place and distance.

runthis.run/llms.txt indexes the catalog for answer engines and crawlers. These are the same pages the site serves, so they are never stale.

Building something else? Tell us.

Beyond the Timer API there is no general-purpose public API. If you have a use case in mind, whether that's an aggregator integration, a training-app sync, or a custom director tool, email hello@runthis.run and describe what you'd build. Concrete requests are what decide which endpoints get built first, and we'd rather hear the use case than guess at it.