Elegí tu ciudad Buenos Aires 

Cupónica API

Por medio de esta API se puede acceder a la información de todas las ofertas publicadas en Cupónica 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.

Pedidos

La siguiente URL, por ejemplo, devuelve un XML con el listado detallado de todas las ofertas en Argentina: https://www.cuponica.com.ar/api/v1/1/AR/deals/

El mismo se compone de las siguientes partes variables: http://<domain>/api/<versión>/<publisher_code>/<country>/<request_type>

Examinemos la URL en detalle:

ParámetroDescripciónEjemploTipo
<domain>Este es el dominio del pais a consultarwww.cuponica.com.arRequerido
<version>La versión de la API (por ahora siempre debe ser v1)v1Requerido
<publisher_code>Usá 1 si no estás seguro1Requerido
<country>ISO Country code del pais a consultarARRequerido
<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/ciudadRequerido

Pedidos de Ciudades

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://www.cuponica.com.ar/api/v1/1/AR/cities/

Extructura del XML devuelto:

Ver ejemplo <?xml version="1.0" encoding="UTF-8"?>
<city-list>
    <city>
        <name>Buenos Aires</name>
        <slug>buenos-aires</slug>
    </city>
    ...
</city-list>

Descripción de los campos:

CampoDescripciónEjemplo
<name>Nombre de la ciudadBuenos Aires
<slug>Código único de la ciudadbuenos-aires

Pedidos de Canales

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://www.cuponica.com.ar/api/v1/1/AR/channels/

Extructura del XML devuelto:

Ver ejemplo <?xml version="1.0" encoding="UTF-8"?>
<channel-list>
    <channel>
        <name>Oferts del dia</name>
        <slug>ofertas-del-dia</slug>
    </channel>
    ...
</channel-list>

Descripción de los campos:

CampoDescripciónEjemplo
<name>Nombre del canalOfertas del dia
<slug>Código único del canalofertas-del-dia

Pedidos de Ofertas

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://www.cuponica.com.ar/api/v1/1/AR/deals/

Extructura del XML devuelto:

Ver ejemplo <?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>

Descripción de los campos y atributos:

CampoDescripciónEjemplo
<coupons-city-name>Nombre de la ciudadbuenos-aires
<url>URL absoluta a la ofertahttps://www.cuponica.com.ar/descuentos-en-buenos-aires/descuentos-en-turismo/pammpa-apart/7721
<title>Titulo de la ofertaEscapada 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érico5.8
<currencyCode>Código ISO de la moneda de la ofertaARS
<formattedAmount>Precio formateado$ 5,80
<beginTime>Fecha de inicio de la oferta2012-03-12T00:00:00
<endTime>Fecha de finalización de la oferta2012-03-12T23:59:59
<purchased>Cantidad vendida15
<coupon-id>Identificador único ASCII del dealescapada-san-bernardo
<category>Nombre de la categoría a la que pertenece la ofertaViajes
addressDirección del negocioAyacucho 1546
nameNombre del negocioCuponica Viajes
latitudLatidud del negocio51.2354
longitudLongitud del negocio33.5478
<channel>Nombre del canalofertas-del-dia

Filtros:

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://www.cuponica.com.ar/api/v1/1/AR/deals/<key>/<value>/

Se puede filtrar por los siguientes atributos:

KeyDescripciónValueEjemplo
cityFiltrar las ofertas publicadas en una determinada ciudadSlug de la ciudad buenos-aires
channelFiltrar las ofertas publicadas en un determinado canalSlug del canalofertas-dia

Ejemplos:

  • Todas las ofertas de Buenos Aires - Ver ejemplohttps://www.cuponica.com.ar/api/v1/1/AR/deals/city/buenos-aires/
  • Todas las ofertas del canal Ofertas del día - Ver ejemplohttps://www.cuponica.com.ar/api/v1/1/AR/deals/channel/ofertas-del-dia/
  • Todas las ofertas de Buenos Aires del canal Ofertas del día - Ver ejemplohttps://www.cuponica.com.ar/api/v1/1/AR/deals/city/buenos-aires/channel/ofertas-del-dia/

CID (parámetro opcional):

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://www.cuponica.com.ar/api/v1/1/AR/deals/?CID=affiliate_654321987

Contactanos para obtener el tuyo.

Cupónica negocios

Promocioná tu negocio con Cupónica hoy mismo.

IngresarContacto

¡Recomendá Cupónica y ganá $10 de crédito!

Referir amigos

¿Tenés una pregunta?

Consultá las preguntas frecuentes y contactanos.

FAQ & Contacto

An Fnbox.com Company  RSSAPISobre CupónicaPrivacidadCondiciones de uso © Cupónica 2014, Todos los derechos reservados