RTVE-API
Documentación (No Oficial) y ejemplos de como usar el API de RTVE
Todas las rutas ya incluyen un ejemplo valido en formato json para ilustrar el funcionamiento. Se recomienda utilizar Jsonviewer para poder visualizar los datos en formato Json más facilmente, por ejemplo.
Encuestas
Documentación
Ejemplos
Rutas
- /encuestas
- /encuestas/mas-vistos
- /encuestas/mas-populares
- /encuestas/{id}
- /encuestas/{id}/breadcrumb - ERROR 400
- /encuestas/{id}/tematicas
- /encuestas/{id}/opciones
- /encuestas/{id}/relacionadas
- /encuestas/{id}/comentarios
Videogalerias
Documentación
Ejemplos
Rutas
- /videogalerias
- /videogalerias/mas-vistos
- /videogalerias/mas-populares
- /videogalerias/{id}
- /videogalerias/{id}/breadcrumb - ERROR 400
- /videogalerias/{id}/multimedias
- /videogalerias/{id}/relacionadas
- /videogalerias/{id}/links
- /videogalerias/{id}/estadisticas
- /videogalerias/{id}/tematicas - ERROR 400
Agr-programas
Documentación
Ejemplos
- Mostrando los audios de un agr-programas partiendo de una ID
- Mostrando los videos de un agr-programas partiendo de una ID
- Mostrando los archivos multimedia de un agr-programas partiendo de una ID
- Mostrando los programas de un agr-programas partiendo de una ID
- Mostrando los detalles de un agr-programa partiendo de una ID
- Mostrando los agr-programas más populares
- Mostrando los agr-programas más vistos
Rutas
- /agr-programas
- /agr-programas/mas-vistos
- /agr-programas/mas-populares
- /agr-programas/{id}
- /agr-programas/{id}/programas
- /agr-programas/{id}/videos
- /agr-programas/{id}/audios
- /agr-programas/{id}/multimedias
Multimedias
Documentación
Ejemplos
- Mostrando un archivo multimedia partiendo de una ID
- Mostrando los archivos multimedia más populares
- Mostrando los archivos multimedia más vistos
Rutas
Noticias
Documentación
Ejemplos
- Mostrando multimedia similar a la noticia partiendo de una ID
- Mostrando noticias similares partiendo de una ID
- Mostrando un archivo multimedia partiendo de una ID
- Mostrando los archivos multimedia más populares
- Mostrando los archivos multimedia más vistos
Rutas
- /noticias
- /noticias/mas-vistos
- /noticias/mas-populares
- /noticias/{id}
- /noticias/{id}/tematicas
- /noticias/{id}/noticias/relacionados
- /noticias/{id}/noticias/especiales
- /noticias/{id}/multimedias/relacionados
- /noticias/{id}/multimedias/totem
- /noticias/{id}/multimedias/destacado
Cadenas
Documentación
Ejemplos
- Mostrando los audios de una cadena partiendo de una ID
- Mostrando los videos de una cadena partiendo de una ID
- Mostrando los programas de una cadena partiendo de una ID
- Mostrando los archivos multimedia de una cadena partiendo de una ID
- Mostrando los detalles de una cadena partiendo de una ID
Rutas
- /cadenas
- /cadenas/mas-vistos
- /cadenas/mas-populares
- /cadenas/{id}
- /cadenas/{id}/programas
- /cadenas/{id}/videos
- /cadenas/{id}/audios
- /cadenas/{id}/multimedias
- /cadenas/{id}/directos/ahora
- /cadenas/{id}/directos/en-vivo/ahora
- /cadenas/{id}/directos/todos/ahora
- /cadenas/{id}/directos/proximos
- /cadenas/{id}/directos/en-vivo/proximos
- /cadenas/{id}/directos/todos/proximos
- /cadenas/{id}/agrupadores
- /cadenas/{id}/videos/mas-vistos
- /cadenas/{id}/audios/mas-vistos
- /cadenas/{id}/multimedias/mas-vistos
- /cadenas/{id}/videos/mas-populares
- /cadenas/{id}/audios/mas-populares
- /cadenas/{id}/multimedias/mas-populares
Agrupadores
Documentación
Ejemplos
- Mostrando los audios de un agrupador partiendo de una ID
- Mostrando los videos de un agrupador partiendo de una ID
- Mostrando los archivos multimedia de un agrupador partiendo de una ID
- Mostrando los programas de un agrupador partiendo de una ID
Rutas
- /agrupadores
- /agrupadores/{id}
- /agrupadores/{id}/hijos
- /agrupadores/{id}/programas
- /agrupadores/{id}/videos
- /agrupadores/{id}/audios
- /agrupadores/{id}/multimedias
Tematicas
Documentación
Ejemplos
- Mostrando los audios de una temática partiendo de una ID
- Mostrando los videos de una temática partiendo de una ID
- Mostrando las noticias de una temática partiendo de una ID
- Mostrando los detalles de una temática partiendo de una ID
Rutas
- /tematicas
- /tematicas/{id}
- /tematicas/{uid}
- /tematicas/{id}/hijos
- /tematicas/{id}/descendientes
- /tematicas/{id}/ancestros
- /tematicas/{id}/videos
- /tematicas/{id}/audios
- /tematicas/{id}/multimedias
- /tematicas/{id}/multimedias/mas-vistos
- /tematicas/{id}/videos/mas-vistos
- /tematicas/{id}/audios/mas-vistos
- /tematicas/{id}/multimedias/mas-populares
- /tematicas/{id}/videos/mas-populares
- /tematicas/{id}/audios/mas-populares
- /tematicas/{id}/noticias
- /tematicas/{id}/noticias/ticker - ERROR 400
- /tematicas/{id}/noticias/ticker/noticias - ERROR 400
- /tematicas/{id}/noticias/ticker/deportes - ERROR 400
- /tematicas/{id}/noticias/mas-vistas
- /tematicas/{id}/noticias/mas-populares
- /tematicas/{id}/publicidad/roba
Blogs
Documentación
Ejemplos
- Mostrando una entrada de blog partiendo de una ID
- Mostrando las entrada de blog más populares
- Mostrando las entrada de blog más vistas
Rutas
- /blogs
- /blogs/mas-vistos
- /blogs/mas-populares
- /blogs/{id}
- /blogs/{id}/breadcrumb - ERROR 400
Programas
Documentación
Ejemplos
- Mostrando los audios de un programa partiendo de una ID
- Mostrando los videos de un programa partiendo de una ID
- Mostrando los archivos multimedia de un programa partiendo de una ID
- Mostrando los detalles de un programa partiendo de una ID
Rutas
- /programas
- /programas/mas-vistos
- /programas/mas-populares
- /programas/{id}
- /programas/{id}/secciones
- /programas/{id}/temporadas
- /programas/{id}/agrupadores
- /programas/{id}/videos
- /programas/{id}/audios
- /programas/{id}/multimedias
- /programas/{id}/relacionados
- /programas/{id}/otras-cadenas
- /programas/{id}/info-infantil
- /programas/{id}/relacionados/relacionados-por-idioma
Videos
Documentación
Ejemplos
- Mostrando un vídeo partiendo de una ID
- Mostrando los videos más populares
- Mostrando los videos más vistos
Rutas
- /videos
- /videos/mas-vistos
- /videos/mas-populares
- /videos/{id}
- /videos/{id}/tematicas
- /videos/{id}/calidades
- /videos/{id}/cuepoints
- /videos/{id}/config/video
- /api/videos/{id}/transcripcion
- /videos/{id}/temporadas
- /videos/{id}/relacionados
- /videos/{id}/relacionados/manuales
- /videos/{id}/publicidad
- /videos/{id}/comentarios
- /videos/{id}/relacionados/relacionados-por-idioma
- /videos/{id}/estadisticas
- /videos/{id}/subtitulos
Audios
Documentación
Ejemplos
- Mostrando un audio partiendo de una ID
- Mostrando los audios más populares
- Mostrando los audios más vistos
Rutas
- /audios
- /audios/mas-vistos
- /audios/mas-populares
- /audios/{id}
- /audios/{id}/estadisticas
- /audios/{id}/relacionados
- /audios/{id}/relacionados/relacionados-por-idioma
- /audios/{id}/relacionados/manuales
- /audios/{id}/publicidad
- /audios/{id}/comentarios
- /audios/{id}/cuepoints
- /audios/{id}/config/audio
- /audios/{id}/transcripcion
- /audios/{id}/temporadas
- /audios/{id}/calidades
Imágenes
Documentación
Ejemplos
- Mostrando un imagen partiendo de una ID
- Mostrando los imágenes más populares
- Mostrando los imágenes más vistos
Rutas
- /imagenes
- /imagenes/mas-vistos
- /imagenes/mas-populares
- /imagenes/{id}
- /imagenes/{id}/breadcrumb
- /imagenes/{id}/calidades
- /imagenes/{id}/tematicas
Medios
Documentación
Ejemplos
- Mostrando los audios de un medio partiendo de una ID
- Mostrando los videos de un medio partiendo de una ID
- Mostrando los archivos multimedia de un medio partiendo de una ID
- Mostrando los programas de un medio partiendo de una ID
- Mostrando los detalles de un medio partiendo de una ID
- Mostrando los archivos multimedia más populares del medio
- Mostrando los archivos multimedia más vistos del medio
Rutas
- /medios
- /medios/{id}
- /medios/{id}/cadenas
- /medios/{id}/programas
- /medios/{id}/videos - ERROR 400
- /medios/{id}/audios - ERROR 400
- /medios/{id}/multimedias - ERROR 400
- /medios/{id}/directos/en-vivo/ahora
- /medios/{id}/directos/todos/ahora
- /medios/{id}/directos/proximos
- /medios/{id}/directos/en-vivo/proximos
- /medios/{id}/directos/todos/proximos
- /medios/{id}/agrupadores
- /medios/{id}/videos/mas-vistos - ERROR 400
- /medios/{id}/audios/mas-vistos - ERROR 400
- /medios/{id}/multimedias/mas-vistos - ERROR 400
- /medios/{id}/videos/mas-populares - ERROR 400
- /medios/{id}/audios/mas-populares - ERROR 400
- /medios/{id}/multimedias/mas-populares - ERROR 400
Queries
-
Format Es posible solicitar los datos en diversos formatos, esta extensión debe colocarse al final de la URL.
http://api.rtve.es/api/tematicas.json
http://api.rtve.es/api/tematicas.xml
http://api.rtve.es/api/tematicas.rss
- Txt, Es una version del xml
http://api.rtve.es/api/tematicas.txt
-
Size Es posible definir la cantidad de datos que esperamos. Mínimo 1 - Máximo 60
http://api.rtve.es/api/tematicas.json?size=60
- Pages Es posible definir la pagina que esperamos. Por defecto se carga la primera página. El número total de páginas esta incluido en la respuesta como "totalPages"
http://api.rtve.es/api/tematicas.json?page=100
-
Lang Es posible realizar la petición para ver el contenido en varios idiomas. Por defecto los resultados se muestran en español
- Español
http://api.rtve.es/api/videos.json?lang=es
- Catalán
http://api.rtve.es/api/videos.json?lang=ca
-
startWithLetter Es posible realizar un filtro de los programas, limtiando los resutlados a la letra deseada
http://www.rtve.es/api/programas.json?startWithLetter=z
- from Podemos realizar un filtro usando una fecha. El formato es ddMMyyyyHHmmss
http://www.rtve.es/api/programas.json?from=02102015001015
- lastDays Podemos realizar un filtro contando los dias hacia atras.
http://www.rtve.es/api/programas.json?lastDays=2
Limitaciones Conocidas
- ?size= -> Mínimo 1 - Máximo 60
- ?lang= -> "es" para español y "ca" para catalán
- Videos -> Es necesario un Token y un Provedor, la url por defecto de todos los videos es "http://ztnr.rtve.es/ztnr/res/_PROVIDER_/video/med/_TOKEN_"
- /blogs/mas-vistos -> duplica/triplica los elementos
- /blogs/mas-populares -> duplica/triplica los elementos
Alternativas Conocidas
Embed
Video embed
Audio embed