• Installs:
  • Today: 52
  • This Week: 261
  • This Month: 934
  • All Time: 631
Developer:userstefan.skliarov

Strava API Package

Strava is the social network for athletes.

List of Endpoints
This is the list of endpoints this API includes. To add of the endpoints to your app, please click on “Connect to endpoint” text.
See All
List of Webhook Events
This is the list of webhook events this API provides. Webhooks allow you to register to certain events and receive real-time data over websockets.
See All
Discussions
See All
Readme

Strava

Strava Package

Strava is the social network for athletes. We’re a global community of millions of runners, cyclists and triathletes, united by the camaraderie of sport.

  • Domain: Strava
  • Credentials: clientId, clientSecret

How to get credentials:

  1. Browse to Strava
  2. Register or log in
  3. Go to API page to get your clientId and clientSecret

Webhook credentials

You can use our service as webhookUrl: https://webhooks.rapidapi.io/api/message/Strava/webhookEvent/{projectName}/{projectKey} * see credentials description below You can add a webhook link at the Dashboard Notifications

Please use SDK to test this feature.

  1. Go to RapidAPI
  2. Log in or create an account
  3. Go to My apps
  4. Add new project with projectName to get your project Key
FieldTypeDescription
projectNamecredentialsYour RapidAPI project name
projectKeycredentialsYour RapidAPI project key

Custom datatypes:

DatatypeDescriptionExample
DatepickerString which includes date and time2016-05-28 00:00:00
MapString which includes latitude and longitude coma separated50.37, 26.56
ListSimple array["123", "sample"]
SelectString with predefined valuessample
ArrayArray of objects[{"Second name":"123","Age":"12","Photo":"sdf","Draft":"sdfsdf"},{"name":"adi","Second name":"bla","Age":"4","Photo":"asfserwe","Draft":"sdfsdf"}]

Strava.getAccessToken

Get access token

FieldTypeDescription
clientIdcredentialsClient id from Strava
clientSecretcredentialsClient secret from Strava
codeStringCode provided by user

Strava.revokeAccessToken

Revoke access token

FieldTypeDescription
accessTokenStringAccess token provided received from Strava

Strava.listFriends

List athlete's friends

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listFollowers

List athlete's followers

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listBothFollowing

Retrieve the athletes who both the authenticated user and the indicated athlete are following.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.getCurrentAthlete

This request is used to retrieve information about the currently authenticated athlete.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava

Strava.getAnotherAthlete

This request is used to retrieve information about any athlete on Strava.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete

Strava.updateCurrentAthlete

Update current athlete's information on Strava.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
cityStringAthlete's city
stateStringAthlete's state
countryStringAthlete's country
sexSelectAthlete's sex
weightStringAthlete's weight

Strava.getZones

Returns the heart rate and power zones of the requesting athlete.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava

Strava.getTotalsAndStats

Returns recent (last 4 weeks), year to date and all time stats for a given athlete.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete. Must match the authenticated athlete

Strava.getKomsAndQoms

Returns an array of segment efforts representing Overall KOMs/QOMs and course records held by the given athlete. Yearly KOMs are not included.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listActivityComments

The number of comments is included in the activity summary and detail responses.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listActivityKudos

A kudos is Strava’s version of a ‘Like’ or a ‘+1’. The number of kudos on an activity is returned with the activity summary.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listActivityPhotos

The number of photos is included in the activity summary and detail responses. Use this endpoint to retrieve a list of photos associated with this activity. This endpoint can only be accessed by the owner of the activity.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.createActivity

Create new activity

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityNameStringName of the Strava activity
activityTypeSelectType of the Strava activity
startDateDatePickerStart date of the Strava activity
elapsedTimeNumberElapsed time in seconds of the Strava activity
descriptionStringDescription of the Strava activity
distanceNumberDistance of the Strava activity
privateBooleanWhether this is private activity
trainerBooleanWhether this is trainer activity

Strava.getSingleActivity

Returns a detailed representation if the activity is owned by the requesting athlete.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
includeAllEffortsBooleanUsed to include all segment efforts in the Result

Strava.updateActivity

Update existing activity

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
activityNameStringName of the Strava activity
activityTypeSelectType of the Strava activity
descriptionStringDescription of the Strava activity
gearIdStringGear ID of the Strava activity
privateBooleanWhether this is private activity
trainerBooleanWhether this is trainer activity

Strava.listMyActivities

This endpoint returns a list of activities for the authenticated user.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
beforeDatePickerResult will start with activities whose startDate is before this value
afterDatePickerResult will start with activities whose startDate is after this value
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listRelatedActivities

Returns the activities that were matched as “with this group”.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listFriendsActivities

List the recent activities performed by the current athlete and those they are following

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
beforeDatePickerResult will start with activities whose startDate is before this value. before and page can not be used in combination. They are independent ways of indicating where in the list of activities to begin the results.
pageNumberNumber of the page to return. before and page can not be used in combination. They are independent ways of indicating where in the list of activities to begin the results.
perPageNumberNumber of items per page to return

Strava.listActivityZones

Heartrate and power zones are set by the athlete. This endpoint returns the time (seconds) in each zone.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity

Strava.listActivityLaps

This resource will return all laps for an activity. Laps are triggered by athletes using their respective devices, such as Garmin watches.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity

Strava.getGroupEvent

Retrieve group event

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
groupEventIdStringId of the Strava group event

Strava.listClubGroupEvents

Returns an array of club group event summary representations ordered by occurrence time.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club
upcomingStringOnly include future events if true

Strava.joinGroupEvent

Join group event

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
groupEventIdStringId of the Strava group event

Strava.leaveGroupEvent

Leave group event

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
groupEventIdStringId of the Strava group event

Strava.deleteGroupEvent

Delete group event

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
groupEventIdStringId of the Strava group event

Strava.listJoinedAthletes

Retrieve summary information about athletes joined a specific group event, or the upcoming occurrence for recurring events.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
groupEventIdStringId of the Strava group event
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.getSingleClub

Retrieve details about a specific club.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club

Strava.listMyClubs

Fetch an array of clubs that the currently authenticated athlete is a member of.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava

Strava.listClubMembers

Retrieve summary information about members of a specific club.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listClubAdmins

Retrieve summary information about admins of a specific club.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.listClubActivities

Retrieve summary information about activities of a specific club.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return
beforeDatePickerResult will start with activities whose startDate is before this value

Strava.joinClub

Join a club on behalf of the authenticated athlete. If the club is private the join will need to be approved by a club admin unless the authenticated athlete had previously been invited to the club.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club

Strava.leaveClub

Leave a club on behalf of the authenticated user.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
clubIdStringId of the Strava club

Strava.getSingleGear

Retrieve details about a specific item of gear. The requesting athlete must own the gear. At this time it is not possible to view just anyone’s gear type and usage.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
gearIdStringId of the Strava gear

Strava.getSingleRoute

Retrieve details about a specific item of gear. The requesting athlete must own the gear. At this time it is not possible to view just anyone’s gear type and usage.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
routeIdStringId of the Strava route

Strava.listRoutes

Lists a specific athlete’s routes. Private routes will only be included if the authenticating user is viewing their own routes and the token has view_private permissions.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
athleteIdStringId of the Strava athlete
afterDatePickerResult will start with activities whose startDate is after this value
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return
typeSelectRoute type

Strava.listRaces

This request is used to retrieve a list of races occurring in a year, ordered by occurrence date from oldest to most recent.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
yearNumberDefaults to the current year

Strava.getSingleRace

This request is used to retrieve details about a running race.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
raceIdStringId of the Strava race

Strava.getSingleSegment

This request is used to retrieve details about a single segment

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
segmentIdStringId of the Strava segment

Strava.listStarredSegments

Returns a summary representation of the segments starred by the authenticated user.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.starSingleSegment

This request is used to star single segment

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
segmentIdStringId of the Strava segment

Strava.unstarSingleSegment

This request is used to unstar single segment

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
segmentIdStringId of the Strava segment

Strava.listSegmentEfforts

Retrieve an array of segment efforts, for a given segment, filtered by athlete and/or a date range.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
segmentIdStringId of the Strava segment
athleteIdStringId of the Strava athlete
startDateDatePickerDate range filtering is accomplished using an inclusive start and end time, thus startDate and endDate must be sent together.
endDateDatePickerDate range filtering is accomplished using an inclusive start and end time, thus startDate and endDate must be sent together.
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.getSegmentLeaderboards

Leaderboards represent the ranking of athletes on specific segments.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
segmentIdStringId of the Strava segment
ageGroupSelectAge group of athletes
weightClassSelectWeight class of athletes in kg
followingBooleanInclude athletes which are followed
clubIdStringId of the Strava club
dateRangeSelectDate range of results
contextEntriesNumberDefault is 2, max of 15
pageNumberNumber of the page to return
perPageNumberNumber of items per page to return

Strava.getSegmentsByCoordinates

This endpoint can be used to find popular segments within a given area.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
swCoordinatesMapSouth west corner coordinates of the area
neCoordinatesMapNorth east corner coordinates of the area
activityTypeSelectType of activity. Default is riding
minCategoryNumberMinimum climb category filter
maxCategoryNumberMaximum climb category filter

Strava.getSegmentSingleEffort

Retrieve details about a specific segment effort. The effort must be public or it must correspond to the current athlete.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
effortIdStringId of the segment effort

Strava.getActivityStreams

Retrieve details about a specific segment effort. The effort must be public or it must correspond to the current athlete.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityIdStringId of the Strava activity
typesList:List of types, if the activity does not have that stream it will not be included in the response
resolutionSelectDefault is all, indicates desired number of data points, streams will only be down sampled
seriesTypeSelectRelevant only if using resolution, used to index the streams if the stream is being reduced

Strava.getEffortStreams

A segment effort represents an attempt on a segment. This resource returns a subset of the activity streams that correspond to that effort.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
effortIdStringId of the Strava effort
typesList:List of types, if the activity does not have that stream it will not be included in the response
resolutionSelectDefault is all, indicates desired number of data points, streams will only be down sampled
seriesTypeSelectRelevant only if using resolution, used to index the streams if the stream is being reduced

Strava.getSegmentStreams

This resource returns a subset of the activity streams that correspond to segment. Only distance, altitude and latlng stream types are available.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
segmentIdStringId of the Strava segment
typesList:List of types, if the activity does not have that stream it will not be included in the response
resolutionSelectDefault is all, indicates desired number of data points, streams will only be down sampled
seriesTypeSelectRelevant only if using resolution, used to index the streams if the stream is being reduced

Strava.getRouteStreams

This resource returns a subset of the activity streams that correspond to route. Distance, altitude and latlng stream types are always returned.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
routeIdStringId of the Strava route

Strava.uploadActivity

Posting a file for upload will enqueue it for processing. Initial checks will be done for malformed data and duplicates.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
activityFileFileThe actual activity data, if gzipped the data_type must end with .gz
dataTypeSelectData type of the file
activityTypeSelectType of the Strava activity
nameStringActivity name. If not provided, will be populated using start date and location, if available
descriptionStringActivity description.
privateBooleanWhether this is private activity
trainerBooleanWhether this is trainer activity. activities without lat/lng info in the file are auto marked as stationary, set to true to force
externalIdStringData filename will be used by default but should be a unique identifie

Strava.checkUploadStatus

Upon upload, Strava will respond with an upload ID. You may use this ID to poll the status of your upload.

FieldTypeDescription
accessTokenStringAccess token provided received from Strava
uploadIdStringId of the upload

Strava.addWebhook

Add new webhook

FieldTypeDescription
clientIdcredentialsClient id from Strava
clientSecretcredentialsClient secret from Strava
objectTypeStringMust match one of the supported object types. E.g. : activity
aspectTypeStringMust match one of the supported aspect types. E.g.: create
webhookUrlStringYou can use our service as webhookUrl. https://webhooks.rapidapi.io/api/message/Strava/webhookEvent/{projectName}/{projectKey}. See details above
verifyTokenStringUser state specified by the user

Strava.listWebhooks

This request is used to retrieve the summary representations of the push subscriptions in place for the current application.

FieldTypeDescription
clientIdcredentialsClient id from Strava
clientSecretcredentialsClient secret from Strava

Strava.deleteWebhook

Delete existing webhook

FieldTypeDescription
clientIdcredentialsClient id from Strava
clientSecretcredentialsClient secret from Strava
webhookIdStringId of the webhook
x
circle
Strava
$ / m
We will charge your card every month for the plan amount, as well as any overages incurred in the previous month.
?

Oops, we are missing some details

Looks like there are a few missing details that you haven't filled in yet.
These details are important and will help us protect you and let you know about anything new.

x

Connect your app to APIs via RapidAPI

Consume and monitor multiple APIs through the RapidAPI SDK.
Click start to set up your app and connect to your first API.

START

Give your app a name

This app will be used in RapidAPI to collect and connect all the APIs you need.

NEXT

Connect your project

Choose your backend language and then install & require the RapidAPI SDK.

  • node
    NodeJS
  • php
    PHP
  • python
    Python
  • objc
    Obj-C
  • android
    Android
  • go
    GO
  • ruby
    Ruby
  • csharp
    C#

Install SDK

Run the following command to install the SDK:

npm install rapidapi-connect --save

Require SDK

In your code, add the following code to require the RapidAPI SDK:

NEXT

Hooray! You are connected

Use the following code to try it out by getting all the APIs that are on RapidAPI.

rapid.call('RapidAPI', 'getAll', {'{}'});
FINISH
esccloses this view
x

Login to RapidAPI

Create endpoints based on popular APIs and share with others.
Follow popular APIs and get updated. Stand out in the community of developers.

Login with Github
Login with Facebook
Login with Google
Or
Remember Me

  • We're not going to post anything on your wall.
  • We're not planning to spam you.
  • esccloses this view
    x

    Why sign up to RapidAPI?

    • integrate
      Integrate APIs into your app
      Ruby, Java, Elixir, Node.js, Phyton, Objective C, Swift, PHP and MORE
    • keys
      Save all API keys in one place
    • notifications
      Get notifications about API changes
    • stats
      Get stats and monitor API connections
    Sign up with Github
    Sign up with Facebook
    Sign up with Google
  • We're not going to post anything on your wall.
  • We're not planning to spam you.
  • esccloses this view
    x

    Authentication

    Authenticate
    esccloses this view