1. INÍCIO
  2. Docs
  3. Documentação Amzpecty
  4. Especificações da API Amzpecty
  5. API de informações do vendedor

API de informações do vendedor

ADICIONAR ID DO VENDEDOR À FILA DE CONSULTA DE INFORMAÇÕES DO VENDEDOR

A solicitação para adicionar um ID do vendedor à fila de consulta de informações do vendedor.

DEDUÇÃO DE CRÉDITO

1 (um) crédito deduzido após recuperação bem-sucedida dos dados.

PEDIDO
URI /api/query/seller/{ID DO VENDEDOR}? domínio={domínio}&secretKey={secretKey} {SELLER ID} – obrigatório – o ID do vendedor do vendedor alvo {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
Cabeçalho HTTP (opcional) AMZPECTY_CALLBACK_URL={Seu URL de retorno}
Exemplo /api/query/seller/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RESPOSTA
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03be54",
    "dateProcessed": null,
    "domain": null
}
INFORMAÇÕES DO VENDEDOR CONSULTA CALLBACK JSON DE AMOSTRA DE DADOS
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerinfo",
    "allowed": 4986,
    "dailyAllowed": 4986,
    "messageId": null,
    "message": null,
    "data": {
            "sellerId": "A3VHYG59GNVJVO",
            "sellerName": "CMDStore",
            "logoUrl": "https://images-na.ssl-images-amazon.com/images/I/419Udl8VRCL.png",
            "businessInfo": {
                "Business Name": "9103-6152 Quebec Inc",
                "Business Address": " 3940 Griffith St Montreal QC H4T1A7 CA",
                "other key": "other value"
            },
            "about": "CMDStore is committed to providing each customer with the highest standard of customer service.",
            "feedbackStar": 4.5,
            "productCount": 2000,
            "feedbackPositive30days": 91,
            "feedbackPositive90days": 95,
            "feedbackPositive12months": 96,
            "feedbackPositiveLifetime": 98,
            "feedbackNeutral30days": 4,
            "feedbackNeutral90days": 1,
            "feedbackNeutral12months": 1,
            "feedbackNeutralLifetime": 1,
            "feedbackNegative30days": 4,
            "feedbackNegative90days": 4,
            "feedbackNegative12months": 3,
            "feedbackNegativeLifetime": 1,
            "feedbackCount30days": 23,
            "feedbackCount90days": 75,
            "feedbackCount12months": 357,
            "feedbackCountLifetime": 13300
            },
   "rid": "60f12c1a0cf24280ed03be5e",
   "dateProcessed": 1626418203388,
   "domain": "www.amazon.com",
   "totalCreditsDeducted": 1
}
ATRIBUTOS JSON DE RESPOSTA DE CHAMADA DE CONSULTA DE INFORMAÇÕES DO VENDEDOR
Nome do AtributoAdicionar ao carrinho
estadoO status da solicitação.
resposta paraValor “sellerinfo” para o resultado da consulta de informações do vendedor.
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.sellerNameO nome online do vendedor.
dados.logoUrlA URL do logotipo do vendedor.
dados.businessInfoMapa de pares de valores-chave, por exemplo
Nome comercial = 9103-6152 Quebec Inc.
Endereço comercial = 558A Hempstead Ave WEST TOWN Nova York 112233 EUA
(outra_chave = outro_valor)
dados.sobreSobre o vendedor.
dados.feedbackStarLista de pares de valores-chave de marcas de produtos comercializados pelo vendedor.
dados.produtoCountO número de produtos do vendedor
** DESCONTINUADO em 2/16/2024 **
data.produtoMarcas[]
Lista de pares de valores-chave de marcas de produtos comercializados pelo vendedor.
data.feedbackPositivo30 diasO feedback positivo do vendedor por um período de 30 dias.
data.feedbackPositivo90 diasO feedback positivo do vendedor por um período de 90 dias.
data.feedbackPositivo12 mesesO feedback positivo do vendedor por um período de 12 meses.
data.feedbackPositiveLifetimeO feedback positivo do vendedor durante o período vitalício.
data.feedbackNeutro30 diasO feedback neutro do vendedor por um período de 30 dias.
data.feedbackNeutro90 diasO feedback neutro do vendedor por um período de 90 dias.
data.feedbackNeutro12 mesesO feedback neutro do vendedor por um período de 12 meses.
data.feedbackNeutralLifetimeO feedback neutro do vendedor durante o período vitalício.
data.feedbackNegativo30 diasO feedback negativo do vendedor por um período de 30 dias.
data.feedbackNegativo90 diasO feedback negativo do vendedor por um período de 90 dias.
data.feedbackNegativo12 mesesO feedback negativo do vendedor por um período de 12 meses.
data.feedbackNegativeLifetimeO feedback negativo do vendedor durante o período vitalício.
data.feedbackCount30 diasO feedback do vendedor conta por um período de 30 dias.
data.feedbackCount90 diasO feedback do vendedor conta por um período de 90 dias.
data.feedbackCount12 mesesO feedback do vendedor conta por um período de 12 meses.
data.feedbackCountLifetimeO feedback do vendedor conta para o período vitalício.

OBTER RESULTADO DE INFORMAÇÕES DO VENDEDOR POR ID DE PEDIDO

A solicitação para obter o resultado das informações do vendedor por ID da solicitação (livre).

DEDUÇÃO DE CRÉDITO

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

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

See Dados de amostra JSON de retorno de chamada de consulta de informações do vendedor

ADICIONE ID DO VENDEDOR PARA OBTER A FILA DE CONSULTA DO VENDEDOR ASINS

A solicitação para adicionar um ID do vendedor à fila de consulta Obter asins do vendedor.

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

DEDUÇÃO DE CRÉDITO

1 (uma) dedução de crédito após recuperação bem-sucedida de 1 página de dados Asin. Cada página contém no máximo 16 Asins.

PEDIDO
URI /api/query/seller/getasins/{ID DO VENDEDOR}? domínio={domínio}&secretKey={secretKey} {SELLER ID} – obrigatório – o ID do vendedor do vendedor alvo {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
Cabeçalho HTTP (opcional) AMZPECTY_CALLBACK_URL={Seu URL de retorno}
Exemplo /api/query/seller/getasins/A3A5YZ4E94TE9K?secretKey=XXXXXXXXXX
RESPOSTA
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4992,
    "dailyAllowed": 4992,
    "messageId": null,
    "message": null,
    "data": null,
    "rid": "60f126e20cf24280ed03b000",
    "dateProcessed": null,
    "domain": null
}
OBTER VENDEDOR ASINS CONSULTA CALLBACK JSON AMOSTRA DE DADOS
Cabeçalhos
Tipo de mídia aplicação / json
Dados JSON
JSON
{
    "status": "OK",
    "responsefor": "sellerasins",
    "allowed": 4986,
    "dailyAllowed": 4986,
    "messageId": null,
    "message": null,
    "data": {
        "sellerId": "A3VHYG59GNVJVO",
        "status": "completed",
        "completedAsins": 2,
        "totalAsins": 2,
        "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 VENDEDOR ASINS CONSULTA CALLBACK RESPOSTA ATRIBUTOS JSON
Nome do AtributoAdicionar ao carrinho
StatusO status da solicitação.
resposta paraValor “sellerinfo” para o resultado da consulta de informações do vendedor.
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.searchStatusO status da pesquisa. “em andamento” ou “concluído”
dados.completedAsinsO número de Asins recuperados. Limite máximo de 2,400 Asins somente mesmo se o vendedor tiver mais de 2,400 Asins. Observe que totalAsins pode não ser igual a completeAsins por vários motivos. Consulte o campo searchStatus para obter o estado da pesquisa.
dados.businessInfoMapa de pares de valores-chave, por exemplo
Nome comercial = 9103-6152 Quebec Inc.
Endereço comercial = 558A Hempstead Ave WEST TOWN Nova York 112233 EUA
dados.totalAsinsO número total de Asins que este vendedor 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 O RESULTADO DO VENDEDOR ASINS POR ID DE PEDIDO

A solicitação para obter o resultado do Seller Asins por Request Id (livre).

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 campo searchStatus para obter o status da pesquisa.

Note: 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/seller/getasins/{ID DO VENDEDOR}? domínio={domínio}&secretKey={secretKey} {SELLER ID} – obrigatório – o ID do vendedor do vendedor alvo {domínio} – opcional – o padrão é www.amazon.com se não for especificado. Ver Domínios Amazon suportados para lista.
Exemplo /api/query/getsellerasin/rid/60f12c1a0cf24280ed03c11d?secretKey=XXXXXXXXXX
RESPOSTA

See Obtenha dados de amostra JSON de retorno de chamada de consulta do vendedor Asins

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