⚠️ This repository is not longer maintained ⚠️

RTVE-API

Documentación (No Oficial) y ejemplos de como usar el API de RTVE

Demos y documentación online

Rutas

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

Ejemplos y detalles

• /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

Ejemplos y detalles

• /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

Ejemplos y detalles

• /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

Ejemplos y detalles

• /multimedias
• /multimedias/mas-vistos
• /multimedias/mas-populares
• /multimedias/{id}

Noticias

Ejemplos y detalles

• /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

Ejemplos y detalles

• /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

Ejemplos y detalles

• /agrupadores
• /agrupadores/{id}
• /agrupadores/{id}/hijos
• /agrupadores/{id}/programas
• /agrupadores/{id}/videos
• /agrupadores/{id}/audios
• /agrupadores/{id}/multimedias

Temáticas

Ejemplos y detalles

Algunos IDs y UIDs importantes

ID	UID	Descripción
814	RT_TEMATI	Temática
815	TE_PORTAD	Categorías
825	TE_NOTICI	Notícias
39190	TE_SESPE01	Especiales
24570	TE_LOSCA01	Los Oscar (General)

• /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

Ejemplos y detalles

• /blogs
• /blogs/mas-vistos
• /blogs/mas-populares
• /blogs/{id}
• /blogs/{id}/breadcrumb - ERROR 400

Programas

Ejemplos y detalles

• /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

Ejemplos y detalles

• /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

Ejemplos y detalles

• /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

Ejemplos y detalles

• /imagenes
• /imagenes/mas-vistos
• /imagenes/mas-populares
• /imagenes/{id}
• /imagenes/{id}/breadcrumb
• /imagenes/{id}/calidades
• /imagenes/{id}/tematicas

Medios

Ejemplos y detalles

• /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.

  • Json

   http://api.rtve.es/api/tematicas.json
  

  • Xml

   http://api.rtve.es/api/tematicas.xml
  

  • RSS

   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

• http://www.rtve.es/drmn/embed/video/{id}

Audio embed

• http://www.rtve.es/drmn/embed/audio/{id}

Información Adiccional

• API RTVE en Wikibooks