Talpa Video Feed Documentatie
De Talpa Video Feed maakt het mogelijk om de video's van kijk.nl te integreren in uw website of applicatie.
Met de automatische video feed kun je de nieuwste video's uit het Partner Portal eenvoudig integreren in je eigen platform. De feed is beschikbaar in zowel JSON als XML en kan periodiek worden opgehaald, bijvoorbeeld via een CRON-job of een andere geautomatiseerde synchronisatie. De feed bevat altijd de meest actuele video's op basis van de filters die je opgeeft, zoals programma, genre, videotype of zender.
Endpoint
Gebruik het volgende productie-endpoint: https://partnerapi.talpanetwork.com/public/video-feed
Authenticatie
Voor iedere aanvraag is een geldige API-key vereist. Je kunt de API-key op twee manieren meesturen;
Als queryparameter: https://partnerapi.talpanetwork.com/public/video-feed?apikey=YOUR_API_KEY
Als HTTP-header (aanbevolen): x-api-key: YOUR_API_KEY
Deze beide methodes worden ondersteund. De API Key wordt verstrekt door het Talpa Network distributieteam. Ook partner worden? Neem dan contact op.
Beschikbare parameters
Parameter | Omschrijving | Waarde |
|---|---|---|
limit | Aantal video’s dat wordt teruggegeven | 1 - 100 |
skip | Aantal resultaten overslaan (pagination) | 0 - 999 |
format | Gewenst responseformaat | json of xml |
sort | Sorteervolgorde | added-desc, added-asc, aired-desc, aired-asc |
genre | Eén of meerdere genres | Meerdere waarden mogelijk sport | entertainment |
series | Eén of meerdere programma’s (series) | Meerdere waarden mogelijk shownieuws | vandaag-inside |
type | Videotypes | CLIP | EPISODE | LIVE |
station | Eén of meerdere zenders | Meerdere waarden mogelijk sbs6 | net5 | sbs9 |
apikey | API-key (indien niet als header gebruikt) | String |
Sortering
De feed ondersteund onderstaande vormen van sortering
Waarde | Uitleg |
|---|---|
added-desc | Nieuwst toegevoegde video’s eerst |
added-asc | Oudst toegevoegde video’s eerst |
aired-desc | Meest recent uitgezonden video’s eerst |
aired-asc | Oudst uitgezonden video’s eerst |
Response
De feed bestaat uit algemene metadata en een lijst met video’s (items). Iedere video bevat onder andere de volgende gegevens.
Veld | Omschrijving |
|---|---|
guid | Unieke video-ID |
type | Videotype |
title | Titel van de video |
description | Beschrijving |
duration | Lengte van de video (seconden) |
genre | Eén of meerdere genres |
seriesTitle | Programmanaam |
seriesSlug | URL-vriendelijke programmanaam |
link | Link naar de videopagina |
thumbnail | URL van de thumbnail |
airedDate | Uitzenddatum |
availableDate | Datum waarop de video beschikbaar komt |
expirationDate | Einddatum van de beschikbaarheid |
oembed | Gegevens om de video eenvoudig te embedden |
Ter voorbeeld de laatste 50 clips van het genre nieuws
https://partnerapi.talpanetwork.com/public/video-feed?limit=50&type=CLIP&genre=Nieuws&format=json&apikey=YOUR_API_KEY
videofeedExample
Video embedden
Iedere video bevat een oembed-object met alle benodigde informatie om de video direct op je eigen website te tonen. Het belangrijkste onderdeel hiervan is het html-veld, waarin een kant-en-klare <iframe> is opgenomen. HTML Voorbeeld:
Belangrijke informatie
Een geldige API-key is verplicht voor iedere aanvraag.
De API-key mag zowel als queryparameter als via de x-api-key-header worden meegestuurd.
De feed ondersteunt zowel JSON als XML.
De feed is bedoeld om periodiek automatisch op te halen, bijvoorbeeld via een geplande synchronisatie (CRON-job).
Dit endpoint maakt gebruik van een nieuwe datastructuur en is niet backwards compatible met eerdere (legacy) implementaties. Bestaande koppelingen dienen daarom te worden aangepast voordat zij gebruik kunnen maken van deze nieuwe feed.