For developers
Developer overview
What you can build against Run This today: a production API for timing companies, a race embed for race websites, and machine-readable mirrors of every public page.
1 min read
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 listing your 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.
Building a race's website? The race's director can copy a one-line embed from their dashboard that shows live registration details: today's price, the next increase, spots left, a countdown and a Register button. Every option is a plain attribute you can edit by hand, it sends browser events you can listen for, and the data behind it is public JSON. See the race embed.
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.mdand/community/your-area.mdrunthis.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.

