ADICIONAR ASIN/ISBN À FILA DE CONSULTA DA API DE REVISÃO DO PRODUTO
A solicitação para adicionar um ASIN/ISBN à fila de consulta de avaliação do produto. A API de avaliações de produtos consultará as análises de produtos com a capacidade de filtrar resultados com base em parâmetros de consulta definidos pelo usuário.
Limitação
A API só pode recuperar no máximo 100 avaliações por combinação de filtros.
DEDUÇÃO DE CRÉDITO
1 (uma) dedução de crédito (por página de Revisão do Produto) após recuperação bem-sucedida dos dados. 5 páginas de análise do produto consumirão 5 créditos se a recuperação for bem-sucedida.
PEDIDO
| URI | /api/query/reviews/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} | {ASIN/ISBN} – obrigatório – o ASIN ou ISBN para adicionar à lista de rastreamento
{domínio} – opcional – o padrão é www.amazon.com se valores válidos não forem especificados [ http://www.amazon.com,/www.amazon.com ] {localização} – opcional – filtre as avaliações por local conforme mostrado na Amazon. Por exemplo (“Estados Unidos”, “México”, “Reino Unido” etc.) {data de} – opcional – filtra as avaliações postadas desde a data especificada (padrão válido “aaaa-MM-dd”) {data para} – opcional – filtra as avaliações postadas até a data especificada (padrão válido “aaaa-MM-dd”) {verifiedpurchaseonly} – opcional – filtra apenas avaliações compradas verificadas (valor válido: “verdadeiro” ou “falso”) {avaliação} – opcional – filtra as avaliações por classificação por estrelas (valores válidos: “1”, “2”, “3”, “4”, “5”) {último} – opcional – se for verdade, obterá apenas as 10 avaliações mais recentes |
| Exemplo | /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 | |
RESPOSTA
| Cabeçalhos | |
| Tipo de mídia | aplicação / json |
| Dados JSON |
JSON
{
"status": "OK",
"allowed": 4971,
"messageId": null,
"message": null,
"data": null,
"rid": "58eb4fb8bfc2333894ce7dc7",
"dateProcessed": null
}Note: Durante o retorno de chamada, o rid pode ser usado para vincular os dados de retorno de chamada à chamada de solicitação original.
CONSULTA DE AVALIAÇÕES DO PRODUTO
SOLICITAÇÃO DE RETORNO DE CONSULTA DE AVALIAÇÕES DO PRODUTO
| URI | Exemplo: https://your.server.com/amzpecty_result | {Forneça o URL na página de preferências} O URL deve estar habilitado para SSL. AMZPECTY-API-SECRET-KEY (nome do cabeçalho) – o cabeçalho da chave secreta será incluído para o servidor de retorno de chamada validar a origem da solicitação |
| Tipo de mídia | aplicação / json |
AVALIAÇÕES DO PRODUTO CONSULTA DADOS DE AMOSTRA JSON DE CALLBACK
| Cabeçalhos | |
| Tipo de mídia | aplicação / json |
| Dados 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
}ATRIBUTOS JSON DE RESPOSTA DE CHAMADA DE CONSULTA DE REVISÃO DO PRODUTO
| Nome do Atributo | Adicionar ao carrinho |
|---|---|
| estado | O status da solicitação. |
| resposta para | Valor “productvariations” para o resultado da consulta de variações do produto |
| permitidas | A contagem atual de solicitações permitidas. Reinicia mensalmente. |
| diariamentePermitido | A contagem de solicitações diárias permitidas atualmente. Reinicia diariamente. |
| mensagemId | O id da mensagem (se houver). |
| mensagem | A mensagem real (se houver). Por favor consulte Mensagens de erro. |
| livrar | O ID da solicitação. Isso pode ser usado para combinar esta resposta com a solicitação original. |
| dataProcessado | A data em que a solicitação foi processada no formato de hora unix. |
| domínio | O domínio Amazon de destino. |
| totalCréditosDeduzidos | Este campo indica quantos créditos da API Amzpecty foram usados para atender esta solicitação. |
| dados.asin | O ASIN do produto. |
| dados. status de pesquisa | O status da pesquisa. [“em andamento”, “concluído”, “erro”] |
| dados. revisarPáginas digitalizadas | O número de páginas de comentários digitalizadas |
| dados. filtros de solicitação | Os filtros especificados pelo usuário para esta solicitação de consulta |
| dados. requestFilters. localização | Filtro de localização. [“Estados Unidos”, “México” etc. conforme mostrado na Amazon] |
| dados. requestFilters. verificadoPurchaseOnly | verdadeiro – devolver apenas compra verificada |
| dados. requestFilters. da data | Revise a data do filtro. [“aaaa-MM-dd” por exemplo “2021-01-01”] |
| dados. requestFilters. a data | Revise a data para filtrar. [“aaaa-MM-dd” por exemplo “2021-12-31”] |
| dados. requestFilters. classificação por estrelas | Filtro de classificação por estrelas [“1”, “2”, “3”, “4”, “5”] |
| data.totalReviews | O total de avaliações conta. |
| dados. totalVerificadoCompra | A contagem total de avaliações de compras verificadas. |
| dados. revisarLocais[] | A lista de locais com a contagem de avaliações correspondente |
| dados. revisarLocations[n].location | O local da revisão |
| dados. reviewLocations[n].reviewCount | A contagem de locais de avaliação |
| dados. classificações [] | A lista de classificações com a contagem de classificações correspondente |
| dados. classificações[n].rating | A classificação da revisão |
| dados. avaliações[n].reviewCount | A contagem de classificação de revisão |
| dados. avaliações[] | A lista de avaliações de usuários com os detalhes das informações correspondentes |
| dados.reviews[n].reviewId | O ID da revisão |
| dados.reviews[n].customerName | O nome do cliente de avaliação |
| dados.reviews[n].customerProfileLink | O link do perfil de avaliação |
| data.reviews[n].customerProfileAvatar | O link do avatar do perfil de avaliação |
| dados.reviews[n].reviewTitle | O título da crítica |
| dados.reviews[n].reviewBody | O corpo de revisão |
| data.reviews[n].reviewLocation | O local da revisão |
| data.reviews[n].reviewDate | A data da revisão |
| data.reviews[n].verifiedPurchase | O sinalizador de compra verificada pela avaliação (“verdadeiro” se verificado) |
| dados.reviews[n].variant | A variante do produto de revisão |
| dados.reviews[n].starRating | A avaliação com estrelas |
| dados.reviews[n].starRatingString | A avaliação com estrelas da avaliação em formato de string |
OBTER RESULTADO DE AVALIAÇÕES DE PRODUTOS POR ASIN/ISBN
A solicitação para obter o resultado mais recente de análises de produtos por ASIN/ISBN.
DEDUÇÃO DE CRÉDITO
0 (zero) dedução de crédito para a chamada Get.
PEDIDO
| URI | /api/query/reviews/asin/{ASIN/ISBN}?domain={domain}&secretKey={secretKey} | {ASIN/ISBN} – o ASIN para obter a lista de rastreamento mais recente {domínio} – opcional – o padrão é www.amazon.com se valores válidos não especificados [ http://www.amazon.com,/www.amazon.com ] |
| Exemplo | /api/query/reviews/asin/B01M5IK8M9?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPOSTA
See Dados de amostra JSON de retorno de chamada de consulta de resultados de análises de produtos
OBTER RESULTADO DE AVALIAÇÕES DO PRODUTO POR RID
A solicitação para obter o resultado mais recente de análises de produtos por RID.
DEDUÇÃO DE CRÉDITO
0 (zero) dedução de crédito para a chamada Get.
PEDIDO
| URI | /api/query/reviews/rid/{rid}?domain={domain}&secretKey={secretKey} | { RID } – o ID da solicitação para obter a lista de variantes mais recente {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista. |
| Exemplo | /api/query/reviews/rid/628c4494e4b06e3bbeaa8b5b?domain=www.amazon.com&secretKey= xxxxxxxxxx | |
RESPOSTA
See Dados de amostra JSON de retorno de chamada de consulta de resultados de análises de produtos
