Elegí tu ciudad Buenos Aires
Por medio de esta API se puede acceder a la información de todas las ofertas publicadas en AGRUPATE obteniendo más información y capacidad de filtrado que los que provee el Feed RSS.
Adicionalmente, se puede consultar ciudades y canales por país.
Esta API devuelve la información en formato XML.
La siguiente URL, por ejemplo, devuelve un XML con el listado detallado de todas las ofertas en Argentina:
https://app.agrupate.com/api/v1/1/AR/deals/
El mismo se compone de las siguientes partes variables:
http://<domain>/api/<versión>/<publisher_code>/<country>/<request_type>
Parámetro | Descripción | Ejemplo | Tipo |
---|---|---|---|
<domain> | Este es el dominio del pais a consultar | www.cuponica.com.ar | Requerido |
<version> | La versión de la API (por ahora siempre debe ser v1) | v1 | Requerido |
<publisher_code> | Usá 1 si no estás seguro | 1 | Requerido |
<country> | ISO Country code del pais a consultar | AR | Requerido |
<request_type> |
Hay 3 tipos de requests:
deals : Devuelve un XML con ofertas disponiblescities : Devuelve la lista de ciudades en un paischannels : Devuelve la lista de canales en un pais/ciudad | Requerido |
Este tipo de pedidos se define con el parámetro request_type=cities
Utiliza este tipo de pedido para obtener el listado de ciudades de un determinado país.
Por ejemplo, la siguiente URL devuelve un XML con las ciudades de Argentina:
https://app.agrupate.com/api/v1/1/AR/cities/
<?xml version="1.0" encoding="UTF-8"?>
<city-list>
<city>
<name>Buenos Aires</name>
<slug>buenos-aires</slug>
</city>
...
</city-list>
Campo | Descripción | Ejemplo |
---|---|---|
<name> | Nombre de la ciudad | Buenos Aires |
<slug> | Código único de la ciudad | buenos-aires |
Este tipo de pedidos se define con el parámetro request_type=channels
Utiliza este tipo de pedido para obtener el listado de canales de un determinado pais.
Por ejemplo, la siguiente URL devuelve un XML con los canales de Argentina:
https://app.agrupate.com/api/v1/1/AR/channels/
<?xml version="1.0" encoding="UTF-8"?>
<channel-list>
<channel>
<name>Oferts del dia</name>
<slug>ofertas-del-dia</slug>
</channel>
...
</channel-list>
Campo | Descripción | Ejemplo |
---|---|---|
<name> | Nombre del canal | Ofertas del dia |
<slug> | Código único del canal | ofertas-del-dia |
Este tipo de pedidos se define con el parámetro request_type=deals
Utiliza este tipo de pedido para obtener el listado de ofertas de un determinado pais.
Por ejemplo, la siguiente URL devuelve un XML con las ofertas de Argentina:
https://app.agrupate.com/api/v1/1/AR/deals/
<?xml version="1.0" encoding="UTF-8"?>
<city-list>
<city-deals>
<coupons-city-name>buenos-aires</coupons-city-name>
<deal>
<url>http://...</url>
<title>Oferta...</title>
<description>Esta oferta...</description>
<price>
<amount>5.3</amount>
<amount>ARS</amount>
<amount>$ 5,30</amount>
</price>
<marketPrice>
<amount>6.8</amount>
<amount>ARS</amount>
<amount>$ 6,80</amount>
</marketPrice>
<discount>
<amount>22</amount>
<amount>ARS</amount>
<amount>$ 22</amount>
</discount>
<beginTime>2012-03-12T00:00:00</beginTime>
<endTime>2012-03-12T23:59:59</endTime>
<purchased>15</purchased>
<coupon-id>oferta-...</coupon-id>
<category>salud...</category>
<business-locations>
<business-location address="Alvear..." name="Casa...">
<geo latitude="12.4567" longitude="33.5568"/>
</business-location>
...
</business-locations>
<channels>
<channel>ofertas-del-dia</channel>
...
</channels>
</deal>
...
</city-deals>
...
</city-list>
Campo | Descripción | Ejemplo |
---|---|---|
<coupons-city-name> | Nombre de la ciudad | buenos-aires |
<url> | URL absoluta a la oferta | https://www.cuponica.com.ar/descuentos-en-buenos-aires/descuentos-en-turismo/pammpa-apart/7721 |
<title> | Titulo de la oferta | Escapada a San Bernardo |
<description> | Descripción de la oferta | ¿No te fuiste de vacaciones a la costa? ¡Nunca es tarde para pasar unos días en la playa! Siempre podés hacer un lugar en... |
<amount> | Precio numérico | 5.8 |
<currencyCode> | Código ISO de la moneda de la oferta | ARS |
<formattedAmount> | Precio formateado | $ 5,80 |
<beginTime> | Fecha de inicio de la oferta | 2012-03-12T00:00:00 |
<endTime> | Fecha de finalización de la oferta | 2012-03-12T23:59:59 |
<purchased> | Cantidad vendida | 15 |
<coupon-id> | Identificador único ASCII del deal | escapada-san-bernardo |
<category> | Nombre de la categoría a la que pertenece la oferta | Viajes |
address | Dirección del negocio | Ayacucho 1546 |
name | Nombre del negocio | Cuponica Viajes |
latitud | Latidud del negocio | 51.2354 |
longitud | Longitud del negocio | 33.5478 |
<channel> | Nombre del canal | ofertas-del-dia |
Existe la posibilidad de filtrar el listado de ofertas por ciudad y/o por canal agregando en la URL el nombre y el valor del atributo por el cual se desea filtrar:
https://app.agrupate.com/api/v1/1/AR/deals/<key>/<value>/
Se puede filtrar por los siguientes atributos:
Key | Descripción | Value | Ejemplo |
---|---|---|---|
city | Filtrar las ofertas publicadas en una determinada ciudad | Slug de la ciudad | buenos-aires |
channel | Filtrar las ofertas publicadas en un determinado canal | Slug del canal | ofertas-dia |
Ejemplos:
https://app.agrupate.com/api/v1/1/AR/deals/city/buenos-aires/
https://app.agrupate.com/api/v1/1/AR/deals/channel/ofertas-del-dia/
https://app.agrupate.com/api/v1/1/AR/deals/city/buenos-aires/channel/ofertas-del-dia/
Como parte del query string se puede pasar el parámetro CID
, el cual es usado para registrar el tráfico enviado por un determinado afiliado.
La siguiente URL, por ejemplo, es la que debería utilizar el afiliado 654321987 para recibir las ofertas de Argentina e identificarse como la fuente de tráfico.
https://app.agrupate.com/api/v1/1/AR/deals/?CID=affiliate_654321987
Contactanos para obtener el tuyo.
Consultá las preguntas frecuentes y contactanos.
RSSAPISobre AGRUPATEPrivacidadCondiciones de uso
© AGRUPATE 2021, Todos los derechos reservados