Search by provider
This endpoint returns a list of learning objects (LO) that matches specific keywords, language and provider.
Last updated
This endpoint returns a list of learning objects (LO) that matches specific keywords, language and provider.
Last updated
The API key must be included in the header.
Make sure to replace SAY-FRIEND-AND-ENTER with your own Developer API key.
Query parameters must be included in the URL.
Parameter | Type | Default | Required | Description |
---|---|---|---|---|
If you want to enforce strictly one specific query paremeter, you can add !important
after it. This parameter wil be applied strictly even if the global match
parameter is set to best-effort
.
See here for Rapid API codes examples.
See below for Direct customer access:
Here is an example of the JSON structured response provided by this endpoint.
Parameter | Required | Description |
---|---|---|
keywords
string
Yes
Keywords help you refine the topic of the learning objects. Best results are obtained when using the most commonly used designation for a skill, a competency or a job.
lang
string
en
Yes
Language of the LO such as en
(english), fr
(french), etc. Use the /lang
endpoint to get the full list of languages currently supported by the API.
provider
string
youtube
Yes
Provider of the LO such as youtube
, coursera
, applebooks
, etc. Use the /provider
endpoint to get the list of the providers currently supported by this endpoint.
sort
string
popularity
Yes
Currently supported sorting order are random
or popularity
. If empty, response will be sorted by popularity
.
match
string
best-effort
Yes
How strict the query parameters are applied. Two matches are currently supported:
strict
match gives you less results but strictly apply all your query parameters.
best-effort
match gives you more results but your query parameters will be loosely applied.
model
string
strict
Yes
The model used by the API to determine if a LO is relevant based on the provided keywords. Two models are currently supported:
strict
model gives you less results but is usually more relevant (less false positive).
extended
model gives you more results but with a higher probability of false positive.
max
integer
10
Yes
Maximum number of LO returned per page. Value must be between 1 to 20.
page
integer
0
Yes
The number of returned page, starting at 0.
publisher
No
Publishers are the organization(s) that offer and/or sell the LO. Formooc
, distance learning
or training
this can be an university, a school or a training organization.
ageMax
integer
No
The maximum age associated to the LO. For example, if you want to see videos for kids only you can set ageMax=10
.
ageMin
integer
No
The minimum age associated to the LO. For example, if you want to see textbooks for adult only you can set ageMin=18
.
learningTimeMax
integer
No
The maximum length of the LO in minute (video
only). For example, if you want to see 5 min or less videos only, you can set learningTimeMax=5
.
learningTimeMin
integer
No
The minimum length of the LO in minute (video
only). For example, if you want to see 1h or more videos only, you can set learningTimeMin=60
.
levelMax
decimal
No
The maximum level of the LO. The level is indicated as decimal number ranging from -1 (beginner) to 1 (advanced). For example, if you want to see a MOOC with a level for beginner, you can set levelMax=-0.5
.
levelMin
decimal
No
The minimum level of the LO. The level is indicated as decimal number ranging from -1 (beginner) to 1 (advanced). For example, if you want to see a MOOC with a level for intermediate or above, you can set levelMin=0.2
.
popularityMin
decimal
No
Popularity is an indicator of the popularity of the LO as measured by its number of likes, stars, views, etc. This parameter enables you to set a threshold to filter out LO below a certain popularity. This value ranges from 0 (low popularity) to 1 (exceptionally popular).
address
string
No
The address around which you want to search. Works only for geolocated learning objects (eg training
). Used in conjuction with distanceMax.
distanceMax
integer
No
The maximum distance within which you want to search. Works only for geolocated learning objects (eg training
). Used in conjuction with address.
free
bool
No
This allows you to filter by free content only (free=true
) or paid content only (free=false
). If empty, you'll get both free and paid contents.
title
Yes
Title of the LO
url
Yes
Link to access the LO
description
Short description of the LO
picture
Link to the thumbnail picture of the LO
provider
Name of the provider associated with this LO
bloom
List of the Bloom objectives associated with this LO
type
List of the type associated with this LO
level
The level is indicated as decimal number ranging from -1 (beginner) to 1 (advanced)
learningTimeValue
Length associated to the LO (based on the unit provided accordingly)
learningTimeUnit
Unit of the length associated to the LO (h
for hour, min
for minutes)
address
Postal address where the learning objects is located (eg training
).
publisher
List of publishers associated with this LO. Publishers are the organization(s) that offer and/or sell the LO. Formooc
, distance learning
or training
this can be an university, a school or a training organization.
author
List of authors associated with this LO. Authors are the people that make the LO. For mooc
,distance learning
or training
this can be a teacher or trainer
.
PriceSpecification
Informations about the pricing of the LO, which includes:
price
is the offer price of the LO as a decimal number.
priceCurrency
is the currency of the price of the LO as a symbol ($
, €
, etc)
price-free
is a boolean that is true
when the LO can be accessed without paying, and false
when the LO requires payment to be accessed.
Beware some providers
such as Coursera offer all their mooc
in both free and paid version. In this case the price of the LO will be not null while marked as price-free=true