XDATA API v1.0

Base url: pf2.it.itba.edu.ar/api/

Nube de palabras

GET /nube-de-palabras

Devuelve la nube de palabras, por default las 200 palabras que mas aparecen en los títulos de las noticias del día de hoy y la cantidad de repeticiones de cada palabra.

Parámetros

Nombre Tipo Descripción
limit Integer el top n de palabras, por default 200
d_from date noticias desde
d_to date noticias hasta
words string títulos de noticias que contienen esta palabra
sources array[integer] id de los diarios separadas por coma

Ejemplos

/nube-de-palabras?limit=3

/nube-de-palabras?d_from=2017-05-19&&d_to=2017-05-22

/nube-de-palabras?sources=7

/nube-de-palabras?words=macri

/nube-de-palabras?d_from=2017-05-19&&d_to=2017-05-22&&words=brasil

Formato de respuesta

{"status": "success", "data": [{"s": 19, "word": "argentina"}, {"s": 15, "word": "dos"}, {"s": 14, "word": "inglaterra"}]}

Cantidad de noticias

GET /cantidad-de-noticias

Devuelve la cantidad de noticias del día. Si le agregas un rango de fechas devuelve la cantidad de noticas de cada día.

Parámetros

Nombre Tipo Descripción
d_from date noticias desde
d_to date noticias hasta
words string títulos de noticias que contienen esta palabra
sources array[integer] id de los diarios separadas por coma

Ejemplos

/cantidad-de-noticias?d_from=2017-05-19

/cantidad-de-noticias?d_from=2017-05-19&&d_to=2017-05-22

/cantidad-de-noticias?words=macri

/cantidad-de-noticias?words=macri&&sources=7

Formato de respuesta

{"status": "success", "data":[{"date": "2017-05-23", "cantidad": 2094}, {"date": "2017-05-22", "cantidad": 1884}, {"date": "2017-05-27", "cantidad": 1020}, {"date": "2017-05-26", "cantidad": 1552}, {"date": "2017-05-25", "cantidad": 1528}, {"date": "2017-05-24", "cantidad": 1891}]}

Heatmap

GET /heatmap

Devuelve la cantidad de noticias del día. Si le agregas un rango de fechas devuelve la cantidad de noticas de cada día separadas por medio.

Parámetros

Nombre Tipo Descripción
d_from date noticias desde
d_to date noticias hasta
words string títulos de noticias que contienen esta palabra
sources array[integer] id de los diarios separadas por coma

Ejemplos

/heatmap?d_from=2017-07-02

/heatmap?d_from=2017-05-19&&d_to=2017-05-22

/heatmap?d_from=2017-05-19&&d_to=2017-05-22&&words=macri

/heatmap?d_from=2017-07-02&&sources=7,20,1,6

Formato de respuesta

{"status": "success", "data": [{"date": "03/07/2017", "source__name": "Clarin", "news_count": 164}, {"date": "04/07/2017", "source__name": "Clarin", "news_count": 186}, {"date": "03/07/2017", "source__name": "El Siglo", "news_count": 14}, {"date": "04/07/2017", "source__name": "El Siglo", "news_count": 9}]}

Tendencias

GET /tendencias

Devuelve cuanta repercusión tuvo una palabra en las noticias en un período de tiempo.

Parámetros

Nombre Tipo Descripción
words *1 string títulos de noticias que contienen esta palabra
d_from * date noticias desde
d_to * date noticias hasta
sources array[integer] id de los diarios separadas por coma

Ejemplos

/tendencias?d_from=2017-05-29&&d_to=2017-05-31&&words=macri, argentina

/tendencias?d_from=2017-02-25&&d_to=2017-02-27&&words=oscar&&sources=7

Formato de respuesta

{"status": "success", "data": [{"publication_date": "2017-05-29", " argentina": 81, "macri": 81}, {"publication_date": "2017-05-30", " argentina": 66, "macri": 100}, {"publication_date": "2017-05-31", " argentina": 82, "macri": 50}]}

Búsqueda

GET /busqueda

Devuelve la url, source, summary y title de las noticias buscadas. La información viene paginada y por default devuelve la primer pagina. Vienen 20 noticias por pagina.

Parámetros

Nombre Tipo Descripción
d_from date noticias desde
d_to date noticias hasta
words string títulos de noticias que contienen esta palabra
sources array[integer] id de los diarios separadas por coma
page integer numero de la pagina de resultados

Ejemplos

/busqueda?words=macri

/busqueda?d_from=2017-05-25&page=1&

/busqueda?d_from=2017-05-25&words=viaje&page=1&

/busqueda?d_from=2017-05-25&d_to=2017-05-27&words=viaje&sources=67,7&

Formato de respuesta

{"status": "success", "data":[{"url": "https://www.diarioeltiempo.com.ar/camino-a-las-copas-en-el-hockey.html", "source": "Diario el Tiempo", "summary": "El 11 de junio se juega la \u00faltima fecha de la fase de grupos de la Liga\nAzule\u00f1a de Hockey, jornada en que quedar\u00e1n definidos los equipos que vayan a\ndisputar la pr\u00f3xima ronda. La forma de clasificaci\u00f3n estipulada contempla que\nlos dos primeros de cada zona formen parte de la copa de oro; los [\u2026]", "title": "CAMINO A LAS COPAS EN EL HOCKEY"}]}

Wordtree

GET /wordtree

Devuelve los títulos de las noticias que contienen la palabra buscada.

Parámetros

Nombre Tipo Descripción
words * string títulos de noticias que contienen esta
d_from date noticias desde
d_to date noticias hasta
sources array[integer] id de los diarios separadas por coma

Ejemplos

/wordtree?words=macri

/wordtree?d_from=2017-05-25&words=paro&

/wordtree?d_from=2017-05-25&words=paro&sources=7&

Formato de respuesta

{"status": "success", "data":[{"title": "Mauricio Macri y Mar\u00eda Eugenia Vidal inauguraron obras en Puente La Noria:\n\"Estamos en el camino correcto\""}, {"title": "Abren la conexi\u00f3n con Camino Negro luego de 3 a\u00f1os de obra en el Puente La\nNoria"}]}

Medios

GET /medios

Devuelve todos los medios con su nombre y id

Parámetros

Nombre Tipo Descripción
sources string nombre del diario

Ejemplos

/medios?sources=clarin

Formato de respuesta

{"status": "success", "data": [{"source": "Clarin", "id": 7}]}

Respuestas de error

Formato de respuesta

{"status": "error", "message": mensajeError}

Mensajes de error

Mensaje Sección
Invalid limit value Nube de palabras
Date from (d_from) parameter is required
Date to (d_to) parameter is required
Date from (d_from) must be previous to Date to (d_to)
Invalid date from (d_from) or date to (d_to) value
Invalid source parameter
One ore more sources where not found
Unexpected error
Parameter page must be an integer Búsqueda
One word is required in the words parameter (words) Tendencias, Wordtree
One or more words separated by ‘,’ are required in the words parameter (words) Tendencias

  1. Parametro requerido.