Learn more about Russian war crimes in Ukraine.

Strava route builder API

The Strava Route Builder lets you build cycling and running routes. It’s backed by an API at https://www.strava.com/routemaster/route. I wanted to use this API for my own purposes, but it’s undocumented, so here are some hints.

The Route Builder takes as input a set of waypoints. You draw these on the map by clicking. For the route between two waypoints, the app makes a call to the API. Given two points, like { lat: 51, lng: 0 }, you can get the route between them with this JS:

function routeBetweenPoints(a, b) {
  return fetch('https://www.strava.com/routemaster/route', {
    method: "POST",
    headers: {
      'Content-Type': 'application/json; charset=utf-8',
      'X-CSRF-Token': document.getElementsByName('csrf-token')[0].getAttribute('content')
    body: JSON.stringify({
      elements: [
        { element_type: 1, waypoint: { point: a } },
        { element_type: 1, waypoint: { point: b } }
      preferences: {
        popularity: 1,
        elevation: 0,
        route_type: 1,
        straight_line: false
  }).then(response => response.json());

This will only work within the Route Builder, because it needs access to csrf-token in the DOM. You can paste it into the console on the Route Builder page. Alternatively, you can get your own CSRF token, and call the API from a script. I leave this to you to achieve.

What can computers do? What are the limits of mathematics? And just how busy can a busy beaver be? This year, I’m writing Busy Beavers, a unique interactive book on computability theory. You and I will take a practical and modern approach to answering these questions — or at least learning why some questions are unanswerable!

It’s only $19, and you can get 50% off if you find the discount code ... Not quite. Hackers use the console!

After months of secret toil, I and Andrew Carr released Everyday Data Science, a unique interactive online course! You’ll make the perfect glass of lemonade using Thompson sampling. You’ll lose weight with differential equations. And you might just qualify for the Olympics with a bit of statistics!

It’s $29, but you can get 50% off if you find the discount code ... Not quite. Hackers use the console!

More by Jim

Tagged #programming. All content copyright James Fisher 2018. This post is not associated with my employer. Found an error? Edit this page.