1. Home
  2. Docs
  3. Documentación de Amzpecty
  4. Especificaciones de la API de Amzpecty
  5. Obtener ASINS por URL

Obtener ASINS por URL

La API de Amzpecty puede escanear todos los ASIN de una URL de resultado de búsqueda de Amazon en particular a través de este módulo API.

AÑADIR URL PARA OBTENER ASINS POR COLA DE CONSULTA DE URL

La solicitud para agregar una URL a la cola de consultas Obtener Asins por URL. La URL es una URL de resultado de búsqueda de Amazon.

Advertencia: La API de Amzpecty solo puede obtener un máximo de 2,400 Asins.

Limitaciones: el recuento de ASIN recuperados puede variar del recuento real de ASIN de Amazon debido a diversos factores, como la ubicación de búsqueda, la dinámica de los listados de Amazon, etc.

DEDUCCIÓN DE CRÉDITO

1 (una) deducción de crédito después de la recuperación exitosa de 1 página de datos Asin. El recuento de Asin por página puede variar.

Solicitudes
URI /api/query/getasinsbyurl?secretKey={secretKey}
Método PUBLICAR
Parámetro POST searchurl={url} donde {url} – obligatorio – la URL de destino, por ejemplo, https://www.amazon.com/s?k=funko&i=warehouse-deals
Encabezado HTTP (opcional) AMZPECTY_CALLBACK_URL={Su URL de devolución de llamada}
Ejemplo /api/query/getasinsbyurl
RESPUESTA
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
     "status": "OK",
     "responsefor": "getasinsbyurl",
     "allowed": 4992,
     "dailyAllowed": 4992,
     "messageId": null,
     "message": null,
     "data": null,
     "rid": "60f126e20cf24280ed03b000",
     "dateProcessed": null,
     "domain": 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.

OBTENER ASINS POR URL CONSULTA DEVOLUCIÓN DE LLAMADA DATOS DE MUESTRA JSON
Cabezales
Tipo de medios aplicación / json
Datos JSON
JSON
{
  "status": "OK",
  "responsefor": "getasinsbyurl",
  "allowed": 4986,
  "dailyAllowed": 4986,
  "messageId": null,
  "message": null,
  "data": {
    "statusInt": 2,
    "status": "Completed",
    "searchUrl": " https://www.amazon.com/s?k=funko&i=warehouse-deals ",
    "expectedTotalAsins": 732,
    "actualAsinsRetrieved": 732,
    "asins": [
      {
        "asin": "B07JLCLVRJ",
        "itemName": "Funko PoP! MArvel",
        "price": 9.99,
        "customerStarRating": "4.5 out of 5 stars",
        "customerReview": "5,006 ratings",
        "linkUrl": "http://www.amazon.com/gp/product/B07JLCLVRJ/ref=silver_xx_cont_revecalc",
        "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
        "otherDetails": [
          "Get it as soon as Tue, Mar 29",
          "$3.99 shipping",
          "Only 1 left in stock - order soon."
        ]
      },
      {
        "asin": "B08XMY2DWM",
        "itemName": "Party House Masters of The Universe Mini Figurines Cake Toppers ",
        "price": 7.4,
        "priceShipping": 0,
        "inventoryWarning": "",
        "customerStarRating": "5 out of 5 stars",
        "customerReview": "1,105 ratings",
        "linkUrl": "http://www.amazon.com/gp/product/B08XMY2DWM/ref=silver_xx_cont_revecalc",
        "imageUrl": "https://m.media-amazon.com/images/I/61Y6N4hBjDL._SL120_.jpg",
        "otherDetails": [
          "Get it as soon as Tue, Mar 29",
          "$2.99 shipping",
          "Only 10 left in stock - order soon."
        ]
      }
    ]
  },
  "rid": "60f12c1a0cf24280ed03be5e",
  "dateProcessed": 1626418203388,
  "domain": "www.amazon.com",
  "totalCreditsDeducted": 1
}
OBTENER ASINS DEL VENDEDOR POR URL CONSULTA RESPUESTA DE LLAMADA ATRIBUTOS JSON

Nombre del AtributoDetalles
estadoEl estado de la solicitud.
respuesta paraValor “getasinsbyurl” para el resultado de la consulta Obtener Asins por URL.
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.sellerIdLa identificación del vendedor.
datos.statusIntEl estado de la búsqueda en formato int. 0 para “En cola”, 1 para “Procesando”, 2 para “Completado” o 3 para “Error”
estado.de.datosEl estado de la búsqueda. “En cola”, “Procesando”, “Completado” o “Error”
data.actualAsinsRecuperadoEl número de Asins recuperados. Límite máximo de 2,400 Asins solo incluso si la URL tiene más de 2,400 Asins. Tenga en cuenta que actualAsinsRecuperado puede que no sea igual a esperadoTotalAsins por varias razones. Por favor consulte la sTatus campo para el estado de búsqueda.
datos.expectedTotalAsinsEl número total de Asins que tiene esta URL.
datos.asins[]La lista de Asins que tiene este vendedor.
asines[n].asinEl Asin del artículo.
asins[n].nombre del artículoEl nombre del artículo del Asin.
asins[n].precioEl precio mostrado del Asin.
asins[n].clienteStarRatingLa calificación de estrellas del cliente de Asin
asins[n].Revisión del clienteEl recuento de reseñas de clientes sobre Asin.
asins[n].linkUrlEl enlace del Asin
asins[n].imageUrlLa URL de la imagen del Asin.
asins[n].otrosDetalles[n]Lista de otros detalles como información de envío, tarifas de envío, advertencia de stock, etc.

OBTENER ASINS POR URL RESULTADO POR ID DE SOLICITUD

La solicitud para obtener el resultado Obtener Asins por URL mediante ID de solicitud (librar).

Tenga en cuenta que puede llamar a esto para recuperar datos de resultados incluso si Amzpecty todavía está buscando datos y no está 100% completo. Puedes consultar el sTatus campo para el estado de búsqueda.

Nota: Evite realizar llamadas sucesivas en intervalos muy cortos. Cada al menos 30 segundos es nuestro intervalo de llamada recomendado.

DEDUCCIÓN DE CRÉDITO

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

Solicitudes
URI /api/query/ getasinsbyurl/rid/{rid}?secretKey={secretKey} {rid} – ID de solicitud de la respuesta /api/query/getasinsbyurl/
Ejemplo /api/query/ getasinsbyurl/rid/60f12c1a0cf24280ed03c122?secretKey=XXXXXXXXXX
RESPUESTA

See OBTENER ASINS POR URL CONSULTA DEVOLUCIÓN DE LLAMADA DATOS DE MUESTRA JSON

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