1. Início
  2. Docs
  3. Documentação Amzpecty
  4. Especificações da API Amzpecty
  5. Obtenha ASINS por URL

Obtenha ASINS por URL

A API Amzpecty pode verificar todos os ASINs de um URL de resultado de pesquisa específico da Amazon por meio deste módulo API.

ADICIONAR URL PARA OBTER ASINS POR FILA DE CONSULTA DE URL

A solicitação para adicionar um URL à fila de consulta Obter Asins por URL. URL é um URL de resultado de pesquisa da Amazon.

Aviso: a API Amzpecty só pode atingir no máximo 2,400 Asins.

Limitações: a contagem de ASIN recuperada pode variar da contagem real de ASIN da Amazon devido a vários fatores, como local de pesquisa, dinâmica das listagens da Amazon, etc.

DEDUÇÃO DE CRÉDITO

1 (uma) dedução de crédito após a recuperação bem-sucedida de 1 página de dados Asin. A contagem de Asin por página pode variar.

PEDIDO
URI /api/query/getasinsbyurl?secretKey={secretKey}
Forma POST
Parâmetro POST searchurl={url} onde {url} – obrigatório – o URL de destino, por exemplo, https://www.amazon.com/s?k=funko&i=warehouse-deals
Cabeçalho HTTP (opcional) AMZPECTY_CALLBACK_URL={Seu URL de retorno}
Exemplo /api/query/getasinsbyurl
RESPOSTA
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
     "status": "OK",
     "responsefor": "getasinsbyurl",
     "allowed": 4992,
     "dailyAllowed": 4992,
     "messageId": null,
     "message": null,
     "data": null,
     "rid": "60f126e20cf24280ed03b000",
     "dateProcessed": null,
     "domain": 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.

OBTER ASINS POR URL QUERY CALLBACK JSON AMOSTRA DE DADOS
Cabeçalhos
Tipo de mídia aplicação / json
Dados 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
}
OBTER ASINS DO VENDEDOR POR URL QUERY CALLBACK RESPOSTA ATRIBUTOS JSON

Nome do AtributoAdicionar ao carrinho
estadoO status da solicitação.
resposta paraValor “getasinsbyurl” para o resultado da consulta Obter Asins por URL.
permitidasA contagem atual de solicitações permitidas. Reinicia mensalmente.
diariamentePermitidoA contagem de solicitações diárias permitidas atualmente. Reinicia diariamente.
mensagemIdO ID da mensagem (se houver).
mensagemA mensagem real (se houver). Consulte Mensagens de erro.
livrarO ID da solicitação. Isso pode ser usado na consulta Get como uma chave.
domínioO domínio Amazon correspondente para o Vendedor.
totalCréditosDeduzidosEste campo indica quantos créditos da API Amzpecty foram usados ​​para atender esta solicitação.
dataProcessadoA data em que a solicitação foi processada no formato de hora unix.
dados.sellerIdO ID do vendedor.
dados.statusIntO status da pesquisa no formato int. 0 para “Na fila”, 1 para “Processando”, 2 para “Concluído” ou 3 para “Erro”
dados.statusO status da pesquisa. “Na fila”, “Processando”, “Concluído” ou “Erro”
data.actualAsinsRetrievedO número de Asins recuperados. Limite máximo de 2,400 Asins somente mesmo que a URL tenha mais de 2,400 Asins. Observe que realAsinsRetrieved pode não ser igual a esperadoTotalAsins por várias razões. Por favor consulte otatuagem campo para estado de pesquisa.
dados.esperadoTotalAsinsO número total de Asins que este URL possui.
dados.asins[]A lista de Asins que este vendedor possui.
asins[n].asinO Asin do item
asins[n].itemNameO nome do item do Asin
asins[n].preçoO preço exibido do Asin
asins[n].customerStarRatingA classificação por estrelas do cliente do Asin
asins[n].customerReviewA contagem de avaliações do cliente do Asin
asins[n].linkUrlO elo do Asin
asins[n].imageUrlO URL da imagem do Asin
asins[n].otherDetails[n]Lista de outros detalhes, como informações de envio, taxas de envio, aviso de estoque, etc.

OBTER ASINS POR URL RESULTADO POR ID DE PEDIDO

A solicitação para obter o resultado Obter Asins por URL por ID de solicitação (livrar).

Observe que você pode chamar isso para recuperar dados de resultados mesmo que Amzpecty ainda esteja procurando dados e não esteja 100% completo. Você pode consultar o statuagem campo para status de pesquisa.

Nota: Evite fazer chamadas sucessivas em intervalos muito curtos. A cada pelo menos 30 segundos é nosso intervalo de chamada recomendado.

DEDUÇÃO DE CRÉDITO

0 (zero) dedução de crédito para a chamada Get.

PEDIDO
URI /api/query/ getasinsbyurl/rid/{rid}?secretKey={secretKey} {rid} – ID da solicitação da resposta /api/query/getasinsbyurl/
Exemplo /api/query/ getasinsbyurl/rid/60f12c1a0cf24280ed03c122?secretKey=XXXXXXXXXX
RESPOSTA

See OBTER ASINS POR URL QUERY CALLBACK JSON AMOSTRA DE DADOS

Este artigo foi útil para você? Sim Não
Como podemos ajudar?