1. Home
  2. Docs
  3. Documentación de Amzpecty
  4. Especificaciones de la API de Amzpecty
  5. API de instantáneas de ASIN

API de instantáneas de ASIN

AÑADIR ASIN/ISBN A LA COLA DE CONSULTAS DE INSTANTÁNEAS DE ASIN

La solicitud para agregar un ASIN/ISBN a la cola de consultas de instantáneas de Asin.

DEDUCCIÓN DE CRÉDITO

1 (una) deducción de crédito después de la recuperación exitosa de los datos.

Solicitudes
URI /api/query/add/{ASIN/ISBN}?domain={dominio}&secretKey={secretKey}&condition={condición} {ASIN/ISBN} – obligatorio – el ASIN o ISBN para agregar a la lista de seguimiento {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
{condición} – opcional – por defecto es nuevo si es nulo/no especificado
valores válidos [nuevo, usado, coleccionable, reacondicionado, todos]
{excluirmoq} – opcional: por defecto es falso si es nulo/no especificado. valores válidos [verdadero, falso]. Si es verdadero, Amzpecty excluirá la búsqueda de moq.
Encabezado HTTP (opcional) AMZPECTY_CALLBACK_URL={Su URL de devolución de llamada}
Ejemplo /api/query/add/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx &condition=used&excludemoq=false
RESPUESTA
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
    "status": "OK",
    "allowed": 4971,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "58eb4fb8bfc2333894ce7dc7",
    "dateProcessed": null
}

Nota: Durante la devolución de llamada, rid se puede utilizar para vincular los datos de la devolución de llamada a la llamada de solicitud original.

DEVOLUCIÓN DE LLAMADA DE CONSULTA DE INSTANTÁNEA ASIN

SOLICITUD DE DEVOLUCIÓN DE LLAMADA CONSULTA DE INSTANTÁNEA DE ASIN
URI Ejemplo: https://your.server.com/amzpecty_result {Proporcione la URL en la página de preferencias} La URL debe tener SSL habilitado. AMZPECTY-API-SECRET-KEY (nombre del encabezado): se incluirá el encabezado de la clave secreta para que el servidor de devolución de llamada valide el origen de la solicitud.
Tipo de medios aplicación / json
ASIN INSTANTÁNEA CONSULTA DEVOLUCIÓN DE LLAMADA JSON DATOS DE MUESTRA
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
    "status": "OK",
    "responsefor": "asinsnapshot",
    "allowed": 4992,
    "dailyAllowed": 500,
    "messageId": null,
    "message": null,
    "data": {
        "queryAsin": "B01MYEYYYY",
        "asin": "B01MYEYYEE",
        "itemName": "Nest 9750016 T3016US Thermostat Black",
        "brand": "by Nest",
        "salesRank": 11346,
        "totalQty": 150,
        "buyboxPrice": "237.15",
        "buyboxSellerName": "JJJ SELLER",
        "buyboxSellerId": "AAW8R82WBLFL9",
        "buyboxItemCondition": "New",
        "totalFBA": 6,
        "totalFBM": 7,
        "maxPrice": 599,
        "minPrice": 237.79,
        "avgPrice": 293.05,
        "isAmazonSelling": false,
        "isAmazonWarehouseSelling": false,
        "customerStarRating": "4.5 out of 5 stars",
        "customerReview": "5,006 ratings",
        "totalOffers": 1,
        "pageNotFound": false,
        "hasVariations": true,
        "unavailable": false,
        "offers": [
            {
                "sellerName": "cables4computer",
                "condition": "New",
                "price": 237.79,
                "priceShipping": 0,
                "priceTotal": 237.79,
                "fba": false,
                "inventoryCount": 11,
                "conditionNote": "",
                "ratingStar": 4.5,
                "sellerRating": "89% positive over the past 12 months. (13,223 total ratings)",
                "prime": false,
                "sellerId": "A3VZC5G7U3OWU4",
                "offerId": "8pwpOXydEI1znRNLYpU",
                "moq": false,
                "moqvalue": 0
            }
        ]
    },
    "rid": "5d6e0b63e4b0e29d7d7d232c",
    "dateProcessed": 1567492992552,
    "domain": "www.amazon.com",
    "totalCreditsDeducted": 1
}
ASIN INSTANTÁNEA CONSULTA RESPUESTA DE LLAMADA ATRIBUTOS JSON
Nombre del AtributoDetalles
estadoEl estado de la solicitud.
respuesta paraValor de “sellerinfo” para el resultado de la consulta de información del vendedor.
permitidoEl recuento de solicitudes permitidas actualmente. Se reinicia mensualmente.
diarioPermitidoEl recuento de solicitudes diarias permitidas actualmente. Se reinicia diariamente.
mensajeIdLa identificación del mensaje (si corresponde).
mensajeEl mensaje real (si lo hay). Consulte Mensajes de error.
librarLa identificación de la solicitud. Esto se puede utilizar en la consulta Obtener como clave.
dominioEl dominio de Amazon correspondiente al Vendedor.
totalCréditosDeducidosEste campo indica cuántos créditos API de Amzpecty se utilizaron para cumplir con esta solicitud.
fechaProcesadoLa fecha en que se procesó la solicitud en formato de hora Unix.
datos.queryAsinEl ASIN especificado en la llamada ADD.
datos.asinEl ASIN del producto. El ASIN puede ser diferente al ASIN especificado en la llamada ADD.
Por ejemplo, en caso de ASIN fusionado o ASIN eliminado.
datos. nombre del árticuloEl nombre del artículo del producto.
datos. marcaLa marca del producto.
datos. Rango de ventasEl precio máximo de todas las ofertas de este producto.
datos. Calidad TotalLa cantidad total estimada del producto.
datos. comprarcajaPrecioEl precio actual de buybox del producto sin incluir el envío.
datos. buyboxNombre del vendedorEl nombre del vendedor actual de Buybox del producto.
datos. buyboxId del vendedorLa identificación del vendedor del vendedor de Buybox.
datos. condición del artículo de buyboxEl estado del artículo de la caja de compra.
datos. total Logística de AmazonEl número total de vendedores de Logística de Amazon.
datos. totalFBMEl número total de vendedores de FBM.
datos. Precio máximoEl precio máximo de todas las ofertas de este producto.
datos. minPrecioEl precio mínimo de todas las ofertas de este producto.
datos. Precio medioEl precio medio de todas las ofertas de este producto.
datos. esAmazonVendiendoBandera de conveniencia si Amazon tiene una oferta para este artículo.
datos. esAmazonWarehouseVentaMarca de conveniencia si Amazon Warehouse tiene una oferta para este artículo.
datos. clienteStarRatingCalificación de estrellas del cliente. Valor de muestra “4.5 de 5 estrellas”
datos. revisión del clienteRecuento de reseñas de clientes. Valor de muestra “5,006 calificaciones”
datos. ofertas totalesEl número total de ofertas de este producto.
datos.no disponiblesSi es verdadero, esta bandera indica que no hay oferta para este producto listado.
data.hasVariacionesSi es cierto, esta bandera indica que existen otras variaciones de este producto.
datos.pageNotFoundSi es verdadero, esta bandera indica que el ASIN no figura actualmente en la lista.
datos.imageUrlLa URL de la imagen del producto.
datos. ofertas[]La lista de ofertas del producto.
ofertas[n]. Nombre del vendedorEl nombre del vendedor que ofrece el producto.
ofertas[n]. ID del vendedorLa identificación del vendedor de esta oferta.
ofertas[n]. condiciónEl estado del producto.
ofertas[n]. precioEl precio del producto.
ofertas[n]. precioEnvíoLa tarifa de envío de esta oferta de producto.
ofertas[n]. precio totalLa suma del precio y envío de la oferta de este producto.
ofertas[n]. fbaSe ofrece la bandera de Logística de Amazon.
ofertas[n]. cuenta de inventarioLa cantidad disponible ofrecida por el vendedor de este producto.
ofertas[n]. Nota CondicionalLa nota sobre el estado del producto. (Si alguna)
ofertas[n]. calificaciónEstrellaLa calificación de estrellas de este vendedor que ofrece el producto.
ofertas[n]. vendedorCalificaciónLa calificación de este vendedor que ofrece el producto.
ofertas[n]. principalLa bandera que indica si esta oferta es elegible para Prime.
ofertas[n]. ID del vendedorLa identificación del vendedor de esta oferta.
ofertas[n]. ID de ofertaLa identificación de esta oferta.
ofertas[n]. pedido mínimoEl indicador de cantidad mínima de pedido de esta oferta. (Si el vendedor impone MOQ)
ofertas[n]. valor moqEl valor de la cantidad mínima de pedido real de esta oferta. (Si el vendedor impone MOQ)

OBTÉN EL RESULTADO DE LA INSTANTÁNEA ASIN POR ASIN/ISBN

La solicitud para obtener el último resultado de Asin Snapshot mediante ASIN/ISBN.

DEDUCCIÓN DE CRÉDITO

0 (cero) deducción de crédito por la llamada Get.

Solicitudes
URI /api/query/get/asin/{ASIN/ISBN}?domain={dominio}&secretKey={secretKey} {ASIN/ISBN}: el ASIN para obtener la lista de seguimiento más reciente {dominio} - opcional - el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
Ejemplo /api/query/get/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx
RESPUESTA

See Datos de muestra JSON de devolución de llamada de instantánea de Asin

OBTÉN EL RESULTADO DE LA INSTANTÁNEA ASIN MEDIANTE ID DE SOLICITUD

La solicitud para obtener el último resultado de la instantánea Asin mediante ID de solicitud (eliminar).

DEDUCCIÓN DE CRÉDITO

0 (cero) deducción de crédito por la llamada Get.

Solicitudes
URI {rid} – ID de solicitud de /api/query/add/ respuesta {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
Ejemplo /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RESPUESTA

See Datos de muestra JSON de devolución de llamada de instantánea de Asin

OBTÉN EL RESULTADO DE LA INSTANTÁNEA ASIN MEDIANTE ID DE SOLICITUD

La solicitud para obtener el último resultado de la instantánea Asin mediante ID de solicitud (eliminar).

DEDUCCIÓN DE CRÉDITO

0 (cero) deducción de crédito por la llamada Get.

Solicitudes
URI {rid} – ID de solicitud de /api/query/add/ respuesta {dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifica. Ver Dominios de Amazon compatibles para la lista.
Ejemplo /api/query/get/rid/58eb0033bfc238234367eb92?domain=www.amazon.com&secretKey=xxxxxxxxxx
RESPUESTA

See Datos de muestra JSON de devolución de llamada de instantánea de Asin

¿Le fue útil este artículo? Si No 1
¿Cómo podemos ayudarle?