Access denied Access granted Authentification Draft Deprecated
video : recommended
Last change: 2023-01-20 14:16:19
Get a scope of recommended videos for the specified category
Parameter
Value
Description
type
[byKinomap|forUser|forVideo|popular|popularTraining]
byKinomap: Default videos recommended by Kinomap
forUser: Videos recommended for the specified username from param value
forVideo: Videos recommended for the specified video id from param value
exclude
Optional parameter for byKinomap type
A list of excluded video ids delimited by |
forceStandard
If set to 1, the return will use a new format implemented (better compliance standard) - Default: 0
hd
Filter -
limit
Number of returned elements - Default: 10 Max: 50
maxAvgPositiveSlope
Filter - 0 to 100 in percent
maxAvgSpeed
Filter - m/s
maxDuration
Filter - Exclude videos upper specified duration (seconds)
maxLength
Filter - Exclude videos upper specified length (meters)
maxPositiveSlope
Filter - in m
minAvgPositiveSlope
Filter - 0 to 100 in percent
minAvgSpeed
Filter - m/s
minDuration
Filter - Exclude videos under specified duration (seconds)
minLength
Filter - Exclude videos under specified length (meters)
minPositiveSlope
Filter - in m
sectionEdited
Filter -
sport
Filter - [cycling|rowing|running]
You can set one or more sport
source
Filter - [camera|smartphone]
start
First element offset - Default: 0
value
Mandatory parameter for forUser (username) and forVideo (video id) type
vehicleId
Filter video query for one or more specified vehicles - Default: empty (all) - Separator: |
minAvgPower
Filter -
maxAvgPower
Filter -
minWorkoutLoad
Filter -
maxWorkoutLoad
Filter -
difficulty
1|2|3|4|5
qualities
Filter - Only show section with these qualities (IDs separated by |) - 0=>Undefined 1=>Bad 2=>Medium 3=>Good 4=>Excellent
outputFormat
Output format - Default: xml
Call
https://api.kinomap.com/video/recommended?
Response Body
An error occured!

	
Response : Valid / Success
  • status: OK when no errors
  • videos: list of elements
Response : Error / Failed
Response status is replaced by one of the following:
  • INVALID_SPORT_VALUE: Invalid sport value (Example of possible value: cycling)
  • INVALID_SOURCE_VALUE: Invalid type value (Example of possible value: camera)
  • INVALID_TYPE_VALUE: Invalid type value (Example of possible value: byKinomap)
  • UNABLE_TO_FIND_USER: The specified user does not exist
  • UNABLE_TO_FIND_VIDEO: The specified videoId does not exist
Sign in