Mountain Project Logo

Mountain Project Data API


Mountain Project provides a simple API with access to certain limited data. All of the data returned by the API is already available on publicly available pages on the Mountain Project site. Returned data is json.

Method: getUser


Returns general user information.

Required Arguments:

key - Your private key

userId - The ID of the user to return

email - The email address of the user to return

* Either userId or email is required, but not both.

Notes:

All returned fields will always be defined, but many are optional for the user and could be empty.

Method: getTicks


Returns up to 200 of the user's most recent ticks.

Required Arguments:

key - Your private key

userId - The ID of the user to return

email - The email address of the user to return

* Either userId or email is required, but not both.

Optional Arguments:

startPos - The starting index of the list to return. Defaults to 0.

Notes:

  • All returned fields will always be defined, but optional fields may be empty.
  • The "hardest" and "average" difficulty are for rock routes only, and only those included in this set (the user may have more ticks than listed here).

Method: getToDos


Returns up to 200 of the user's to-dos.

Required Arguments:

key - Your private key

userId - The ID of the user to return

email - The email address of the user to return

* Either userId or email is required, but not both.

Optional Arguments:

startPos - The starting index of the list to return. Defaults to 0.

Notes:

All returned fields will always be defined, but optional fields may be empty.

Method: getRoutes


Returns details for up to 200 routes.

Required Arguments:

key - Your private key

routeIds - A comma-separated list of route IDs, up to 100

Notes:

  • All returned fields will always be defined, but optional fields may be empty.
  • The value of "stars" is 1-5 inclusive. On the MP site, 1 star means a "bomb" and 5 stars corresponds to a 4-star graphic.
  • The "location" array is variable in length and depends on the number of parent areas above the route.
  • "imgSmall" and "imgMed" may be empty if there are no images of this route.
  • Route data changes very slowly. Please cache this data for at least a week.

Method: getRoutesForLatLon


Returns routes for a given query.

Required Arguments:

key - Your private key

lat - Latitude for a given area

lon - Longitude for a given area

Optional Arguments:

maxDistance - Max distance, in miles, from lat, lon. Default: 30. Max: 200.

maxResults - Max number of routes to return. Default: 50. Max: 500.

minDiff - Min difficulty of routes to return, e.g. 5.6 or V0.

maxDiff - Max difficulty of routes to return, e.g. 5.10a or V2.

Notes:

All returned fields will always be defined, but optional fields may be empty.

Private Key


Sign up or log in to get your key

All requests require a private key that identifies you. Usage of the API is at Mountain Project's sole discretion and may be discontinued at any time. We track every request — be sure your code caches data and does not make excessive requests or your account will be deactivated.