AÑADIR ASIN/ISBN A LA COLA DE CONSULTAS DE API DE REVISIÓN DE PRODUCTOS
La solicitud para agregar un ASIN/ISBN a la cola de consultas de Revisión de productos. La API de reseñas de productos consultará las reseñas de productos con la capacidad de filtrar los resultados según los parámetros de consulta definidos por el usuario.
Limitación
La API solo puede recuperar un máximo de 100 reseñas por combinación de filtros.
DEDUCCIÓN DE CRÉDITO
1 (una) deducción de crédito (por página de Revisión del producto) después de la recuperación exitosa de los datos. 5 páginas de revisión del producto consumirán 5 créditos si la recuperación se realiza correctamente.
SOLICITAR
| URI | /api/query/reviews/{ASIN/ISBN}?domain={dominio}&secretKey={secretKey} | {ASIN/ISBN} – requerido – el ASIN o ISBN para agregar a la lista de seguimiento
{dominio} – opcional – el valor predeterminado es www.amazon.com si no se especifican valores válidos [ http://www.amazon.com,/www.amazon.com ] {ubicación} – opcional – filtrar reseñas por ubicación como se muestra en Amazon. Por ejemplo (“Estados Unidos”, “México”, “Reino Unido”, etc.) {fecha de} – opcional – filtra las reseñas publicadas desde la fecha indicada (patrón válido “aaaa-MM-dd”) {fecha a} – opcional – filtra las reseñas publicadas hasta la fecha indicada (patrón válido “aaaa-MM-dd”) {compra verificada solamente} – opcional – filtra solo reseñas compradas verificadas (Valor válido: “verdadero” o “falso”) {clasificación} – opcional – filtra reseñas por clasificación de estrellas (valores válidos: “1”, “2”, “3”, “4”, “5”) {últimamente} – opcional – si es verdadero, solo obtendrá las 10 reseñas más recientes |
| Ejemplo | /api/query/reviews/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx&location=Mexico&datefrom=2021-01-01&dateto=2021-12-31&verifiedpurchaseonly=true&rating=5&latestonly=true | |
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
}Note: 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.
RESEÑAS DE PRODUCTOS CONSULTA DEVOLUCIÓN DE LLAMADA
RESEÑAS DE PRODUCTOS CONSULTA SOLICITUD DE DEVOLUCIÓN DE LLAMADA
| 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 |
RESEÑAS DE PRODUCTOS CONSULTA DEVOLUCIÓN DE LLAMADA DATOS DE MUESTRA JSON
| Cabezales | |
| Tipo de medios | aplicación / json |
| Datos JSON |
JSON
{
"status": "OK",
"responsefor": "productreviews",
"allowed": 108974,
"dailyAllowed": 9903,
"messageId": null,
"message": null,
"data": {
"asin": "B01M5IK8M9",
"searchStatus": "completed",
"reviewPagesScanned": 4,
"requestFilters": {
"location": "United States",
"verifiedPurchaseOnly": true,
"fromDate": "Jan 01, 2021",
"toDate": "Dec 31, 2021",
"starRating": "5"
},
"totalReviews": 21,
"totalVerifiedPurchase": 21,
"reviewLocations": [
{
"location": "United States",
"reviewCount": 21
}
],
"ratings": [
{
"rating": "5.0 out of 5 stars",
"reviewCount": 21
}
],
"reviews": [
{
"reviewId": "R5N2Q27S1WE1P",
"customerName": "Spirit_Child",
"customerProfileLink": "https://www.amazon.com/gp/profile/amzn1.account.AFE7FQ7FOLUVIUTTUKVF3MVMUPFQ/ref=cm_cr_getr_d_gw_btm?ie=UTF8",
"customerProfileAvatar": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
"reviewTitle": "I love it!",
"reviewBody": "It delivered on time & it’s what I was expecting!!",
"reviewLocation": "United States",
"reviewDate": "Dec 22, 2021",
"verifiedPurchase": true,
"variant": "Size: Standard",
"starRating": 5,
"starRatingString": "5.0 out of 5 stars"
}
]
},
"rid": "628c4494e4b06e3bbeaa8b5b",
"dateProcessed": 1653359777214,
"domain": "www.amazon.com",
"totalCreditsDeducted": 1
}REVISIÓN DEL PRODUCTO CONSULTA DEVOLUCIÓN DE LLAMADA RESPUESTA ATRIBUTOS JSON
| Nombre del Atributo | Detalles |
|---|---|
| estado | El estado de la solicitud. |
| respuesta para | Valor de “variaciones de producto” para el resultado de la consulta Variaciones de producto |
| permitido | El recuento de solicitudes permitidas actualmente. Se reinicia mensualmente. |
| diarioPermitido | El recuento de solicitudes diarias permitidas actualmente. Se reinicia diariamente. |
| mensajeId | La identificación del mensaje (si corresponde). |
| mensaje | El mensaje real (si lo hay). Por favor consulte Mensajes de error. |
| librar | La identificación de la solicitud. Esto se puede utilizar para hacer coincidir esta respuesta con la solicitud original. |
| fechaProcesado | La fecha en que se procesó la solicitud en formato de hora Unix. |
| dominio | El dominio de Amazon de destino. |
| totalCréditosDeducidos | Este campo indica cuántos créditos API de Amzpecty se utilizaron para cumplir con esta solicitud. |
| datos.asin | El ASIN del producto. |
| datos. estado de búsqueda | El estado de la búsqueda. [“en curso”, “completado”, “error”] |
| datos. revisar páginas escaneadas | El número de páginas de reseñas escaneadas. |
| datos. solicitarfiltros | El usuario especificó filtros para esta solicitud de consulta. |
| datos. Solicitar filtros. ubicación | Filtro de ubicación. [“Estados Unidos”, “México”, etc. como se muestra en Amazon] |
| datos. Solicitar filtros. verificadoSoloCompra | verdadero: devolver solo compras verificadas |
| datos. Solicitar filtros. partir de la fecha | Fecha de revisión del filtro. [“aaaa-MM-dd”, por ejemplo, “2021-01-01”] |
| datos. Solicitar filtros. hasta la fecha | Fecha de revisión para filtrar. [“aaaa-MM-dd”, por ejemplo, “2021-12-31”] |
| datos. Solicitar filtros. calificación de estrellas | Filtro de clasificación por estrellas [“1”, “2”, “3”, “4”, “5”] |
| data.totalReseñas | El total de reseñas cuenta. |
| datos. totalCompra verificada | El recuento total de reseñas de compras verificadas. |
| datos. revisarUbicaciones[] | La lista de ubicaciones con su correspondiente recuento de reseñas. |
| datos. revisarUbicaciones[n].ubicación | La ubicación de la revisión. |
| datos. ubicaciones de revisión[n].reviewCount | El recuento de ubicaciones de revisión |
| datos. calificaciones [] | La lista de calificaciones con su correspondiente recuento de calificaciones. |
| datos. calificaciones[n].calificación | La calificación de revisión |
| datos. calificaciones[n].reviewCount | El recuento de calificaciones de reseñas |
| datos. reseñas[] | La lista de opiniones de usuarios con su correspondiente detalle informativo. |
| datos.revisiones[n].reviewId | La identificación de la revisión |
| datos.revisiones[n].nombredelcliente | El nombre del cliente de revisión |
| datos.reviews[n].customerProfileLink | El enlace de revisión del perfil |
| datos.reviews[n].customerProfileAvatar | El enlace del avatar del perfil de revisión |
| datos.revisiones[n].reviewTitle | El título de la reseña. |
| datos.revisiones[n].reviewBody | El organismo de revisión |
| datos.reviews[n].reviewLocation | La ubicación de la revisión. |
| datos.revisiones[n].fecharevisión | la fecha de revisión |
| data.reviews[n].compra verificada | La marca de compra verificada por revisión ("verdadera" si está verificada) |
| datos.revisiones[n].variante | La variante del producto de revisión. |
| datos.reviews[n].starRating | La calificación de estrellas de la reseña |
| datos.reviews[n].starRatingString | La calificación de estrellas de la reseña en forma de cadena |
OBTENER RESULTADOS DE RESEÑAS DE PRODUCTOS POR ASIN/ISBN
La solicitud para obtener el resultado más reciente de Reseñas de productos mediante ASIN/ISBN.
DEDUCCIÓN DE CRÉDITO
0 (cero) deducción de crédito por la llamada Get.
SOLICITAR
| URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={dominio}&secretKey={secretKey} | {ASIN/ISBN}: el ASIN para obtener la lista de seguimiento más reciente {dominio} – opcional: por defecto es www.amazon.com si no se especifican valores válidos [ http://www.amazon.com,/www.amazon.com ] |
| Ejemplo | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPUESTA
See Reseñas de productos Consulta de resultados Devolución de llamada Datos de muestra JSON
OBTENER RESULTADOS DE RESEÑAS DE PRODUCTOS POR RID
La solicitud para obtener el resultado más reciente de Reseñas de productos mediante RID.
DEDUCCIÓN DE CRÉDITO
0 (cero) deducción de crédito por la llamada Get.
SOLICITAR
| URI | /api/query/reviews/rid/{rid}?domain={dominio}&secretKey={secretKey} | {RID}: el ID de solicitud para obtener la lista de variantes 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/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPUESTA
See Reseñas de productos Consulta de resultados Devolución de llamada Datos de muestra JSON
