Every GET request must include a parameter called “api_key” with your granted key as value.
Non-authenticated requests will be answered by a HTTP 401 response code as follows:
The REST API has a rate limitation policy based on 15 minutes slot.
The rate limit is set to 100 requests per slot.
Whenever this rate is exceeded, the request will response a HTTP 401 code with a JSON encoded message as follows:
The count will be reset to 0 once the current time slot is over.
If you think your particular usage of the API requires a higher rate, do not hesitate to contact us.
You may also consider using our PUSH API to get rid of this limitation.
We support 22 channels from the french TV broadcast (TNT), with the supported features below.
|Channel name||Channel Id||Supported metadata|
|France 2||2||FULL SUPPORT|
|France 3||3||FULL SUPPORT|
|Canal +||4||FULL SUPPORT (non-crypted programs only)|
|France 5||5||FULL SUPPORT|
|France 4||14||FULL SUPPORT|
|BFM TV||15||Snapshots only|
|France Ô||19||FULL SUPPORT|
|RMC Découverte||24||FULL SUPPORT|
Since parameter behaviour
Most of the endpoints accept a “since” parameter which is the minimum timestamp requested for the returned tags.
It is strongly recommended to use efficiently this parameter when polling the API.
For bandwith-optimization reasons, in case this parameter is not provided or is set to 0, then an automatic since is applied, valued with the timestamp of the latest tag retrieved by the same API user. As a consequence, if you request a given resource without a since value twice, the second request won't return any tags (unless a new tag appeared between the 2 requests of course.)