Strava route builder API

The Strava Route Builder lets you build cycling and running routes. It’s backed by an API at 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('', {
    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.

Tagged #programming.

Similar posts

More by Jim

Want to build a fantastic product using LLMs? I work at Granola where we're building the future IDE for knowledge work. Come and work with us! Read more or get in touch!

This page copyright James Fisher 2018. Content is not associated with my employer. Found an error? Edit this page.