Comment on page
Explore our guides and examples to integrate the Inokufu web services APIs.
The Inokufu web services APIs allow you to programmatically access Inokufu data and tools. You can use these APIs to retrieve information about learning objects, search for learning objects meeting specific criteria, explore domains of competency and more.
Inokufu APIs are divided into two distinct APIs: Learning Object and Competency. Each of these services has its own page in this documentation. The documentation for each API is structured by endpoints. An endpoint is a specific method within an API that performs one action and is located at a specific URL.
The Learning Object API gives you access to our ever-increasing index of 3M+ learning objects from various providers such as YouTube, Coursera, edX, Openclassrooms, Apple podcasts, Google Play Store, Apple Books, Amazon Books, Instructables, Medium, etc.
The Competency API enables you to explore and connect skills, occupations or domains of knowledge from various taxonomies and frameworks such as Wikipedia, ESCO classification, ROME codes from Pôle Emploi, Formacode®, etc.
Each API endpoint in this documentation is described using several parts:
- The HTTP method. Includes
- The base path. URLs referenced in the documentation have a base path such as
https://api.inokufu.com/learningobject/v2. This base path goes before the endpoint path. Note that if you use RapidAPI to connect to our APIs, you should use the base URL provided by RapidAPI, such as
- The endpoint path. This path goes after the base path and enable you to access the specific endpoint you need. For example, to access the Search endpoint of the Learning object API v2, you must add
/searchto the base path:
- Required parameters. These parameters must be included in a request. Query parameters are added to the end of the URL with query string encoding. In the example above,
type=videoare required parameters.
- Optional parameters. These parameters can be included in a request to customize the query.
- Authentication. If an API endpoint requires authentication, the API key must be included in the request header.
Each Inokufu API has a version string that is specified in the base URL. The version string for a given Inokufu API can be incremented independently from other Inokufu APIs. We encourage you to use the newest available version of the Inokufu APIs.
The following changes to a Inokufu API are considered backwards compatible. The version string of an API will not be incremented if we:
- Add properties to JSON objects.
- Change the number of items returned in a single listing request.
- Change rate limiting thresholds.
- Change the structure or length of identifiers generated by the API.
- Change error messages.
The following changes are considered backwards incompatible. The version string of an API will be incremented if we:
- Remove properties from JSON objects.
- Change an API's URL structure.
If we deprecate an API or API endpoint that you are using, we will email you to give you at least 90 days' notice.
Each Inokufu API has rate limits that cap the number of requests you can make against an endpoint. If you exceed a rate limit, your request will be throttled, and you will receive a
HTTP 429 Too Many Requestsresponse from the API.
The maximum URL length that our APIs accept before returning a HTTP
414 URI too longresponse status code is an 8,192 byte limit. Note that some APIs accept
POSTrequests with the query parameters in the request body as a workaround for this limitation. The documentation for each endpoint indicates which HTTP request methods it accepts.
We recommend that all access to Inokufu APIs is over HTTPS. Requests initiated over HTTP are automatically upgraded to HTTPS.
Pagination lets you list many objects from an API by using more than one request.
In the Inokufu API endpoints that support pagination, the optional
maxparameter specifies the maximum number of objects to return. The API will try to return the requested number of objects.
You may experience timeout during the first calls to our endpoints after a long period of inactivity when using demo or free keys. Don't worry, wait a few minutes and make your call again, everything should work as usual. There is no cold start issue when using a paid key.