Monitoramento de preço no ecommerce: guia com APIs

Seu produto custa R$ 219 com frete grátis. Na busca do concorrente, ele aparece por R$ 199. A primeira reação é baixar o preço. Mas, ao abrir a oferta, você descobre um frete de R$ 29,90: para aquele CEP, o concorrente cobra R$ 228,90 no total. Sua loja já tinha a melhor oferta entre as duas, e um desconto teria consumido margem sem resolver um problema real.

Esse exemplo hipotético mostra por que monitoramento de preço precisa ir além do número exibido na vitrine. Para tomar uma decisão, seu ecommerce precisa identificar o produto, confirmar a variação, entender quem vende, comparar as condições de compra e acompanhar o que mudou ao longo do tempo.

Com as APIs para ecommerce da GeckoAPI, você consulta dados públicos de marketplaces e varejistas em JSON e alimenta sua própria rotina de inteligência de preços. Neste guia, você verá como escolher as fontes, comparar ofertas equivalentes, montar um histórico de preços e criar alertas que ajudem a proteger a margem.

O que é monitoramento de preço?

Monitoramento de preço é o acompanhamento recorrente do valor e das condições de venda de um produto em uma ou mais lojas. Cada consulta registra uma observação com data, fonte, vendedor e contexto da oferta. A comparação dessas observações permite detectar aumentos, quedas, promoções e mudanças na competitividade.

No ecommerce, a mesma mercadoria pode aparecer em vários anúncios, vendedores e canais. Por isso, o monitoramento de preços online combina três trabalhos: encontrar ofertas relevantes, confirmar quais correspondem ao seu produto e consultar essas ofertas ao longo do tempo.

Uma comparação feita hoje responde quem está mais barato na amostra atual. Um histórico mostra se a diferença é persistente, se apareceu durante uma campanha ou se desapareceu na coleta seguinte. Essa continuidade permite usar os dados em decisões de pricing, compras, sortimento e campanhas.

Quem usa monitoramento de preços no ecommerce

Operação	Pergunta que os dados ajudam a responder
Loja virtual	Meu preço final está competitivo nos produtos que mais vendem?
Marca ou fabricante	Como minhas ofertas se posicionam entre loja própria e revendedores?
Distribuidor	Quais produtos merecem revisão comercial ou reposição?
Equipe de pricing e BI	A mudança de preço é recorrente e afeta quais categorias?
ERP, plataforma ou software de varejo	Como oferecer comparações e alertas dentro do meu produto?

Se o objetivo específico é acompanhar anúncios abaixo de uma referência da marca, veja também o guia de monitoramento de preço mínimo e PMA.

Como comparar preços sem perder margem

O primeiro desafio do monitoramento de preço de concorrentes é estabelecer o que pode ser comparado. Um título parecido ajuda na busca, mas não confirma equivalência: um celular de 128 GB, outro de 256 GB e um aparelho recondicionado podem aparecer lado a lado.

Antes de calcular a diferença, verifique marca, modelo, capacidade, cor quando relevante, voltagem, quantidade por embalagem e condição do produto. Use EAN ou GTIN quando a fonte oferecer esses identificadores e confirme os atributos. Um SKU interno de uma loja não necessariamente identifica o mesmo item em outra.

O menor preço anunciado pode não ser o menor preço final

Considere estas ofertas fictícias do mesmo produto, novo, para o mesmo CEP e com pagamento à vista:

Oferta	Produto	Frete	Condição	Total comparável
Sua loja	R$ 219,00	R$ 0,00	Disponível	R$ 219,00
Concorrente A	R$ 199,00	R$ 29,90	Disponível	R$ 228,90
Concorrente B	R$ 209,00	R$ 0,00	Sem estoque	Excluir da disputa atual
Concorrente C	R$ 189,00	Não informado	Cupom de primeira compra	Avaliar separadamente

Entre as ofertas disponíveis e com condições confirmadas, sua loja tem o menor total. A diferença para o concorrente A é de R$ 9,90. Já a oferta C exige verificar elegibilidade e frete antes de entrar na comparação.

Uma regra de cálculo para sua aplicação é:

preço final comparável = preço do produto
                      + frete para o CEP escolhido
                      - desconto confirmado para o cenário

Mantenha preços à vista e parcelados em cenários separados. Cupons, benefícios de clube, troca de aparelho e vantagens para novos clientes precisam de condições explícitas. Se o frete ou o desconto não estiver disponível, registre a lacuna. Valor ausente não significa frete grátis, preço zero ou produto indisponível.

Esse cuidado evita uma sequência cara: comparar produtos diferentes, gerar um alerta incorreto e reduzir o próprio preço por causa dele.

APIs para monitoramento de preço em marketplaces e varejistas

A GeckoAPI oferece uma camada de extração para consultar páginas públicas de ecommerce. As chamadas usam POST https://api.geckoapi.com.br/v1/extract, autenticação Bearer e parâmetros que identificam a fonte e o tipo de consulta.

Para montar seu monitoramento, comece pelos canais que realmente disputam seus produtos. Um catálogo de eletrodomésticos pode exigir fabricantes e grandes varejistas; moda e acessórios podem precisar de outro conjunto de fontes.

Fonte e API	Aplicação no monitoramento
Mercado Livre	Descobrir anúncios, consultar preço, seller e disponibilidade; a PDP aceita CEP opcional para consultar frete e prazo.
Amazon Brasil	Acompanhar buscas e páginas de produto, preços, vendedores e variações presentes na resposta.
Shopee	Pesquisar ofertas e consultar detalhes, variações, seller e estoque informado.
Magazine Luiza e Casas Bahia	Combinar consultas de produtos com endpoints específicos de cotação de frete por URL e CEP.
TikTok Shop	Encontrar produtos por busca e consultar preço, faixa de valores, variantes e loja por ID ou URL.
Temu	Consultar buscas e produtos nos catálogos do Brasil, Estados Unidos e Reino Unido, preservando região e moeda.
SHEIN, AliExpress e Dafiti	Ampliar a pesquisa de sortimento e ofertas, adaptando o tratamento dos dados ao contrato de cada conector.
Samsung, Electrolux e Brastemp	Consultar lojas de fabricantes e comparar preços, pagamento à vista, atributos, EAN e variações quando disponíveis.

Os campos e parâmetros variam entre conectores. Um campo pode vir como null, uma lista pode estar vazia e uma fonte pode não oferecer frete ou avaliações. Samsung, Electrolux e Brastemp, por exemplo, retornam preço e disponibilidade do catálogo sem CEP; esses conectores não fornecem cotação de frete.

O mesmo endpoint simplifica a integração HTTP, enquanto a documentação de cada API orienta a normalização. Você define as regras de equivalência, guarda o histórico e constrói os alertas no seu sistema. A GeckoAPI fornece os dados de extração usados por essa operação.

Como fazer monitoramento de preço com API: passo a passo

Uma implantação prática começa com um grupo pequeno de produtos e uma pergunta comercial clara. Por exemplo: “Em quais itens da minha curva A uma oferta equivalente está pelo menos 5% abaixo do meu preço final?”. O limite de 5% é ilustrativo; ajuste-o à margem, à categoria e à frequência de decisão da sua operação.

1. Defina produtos, fontes e condições de comparação

Monte uma tabela com seu identificador interno, modelo, EAN quando conhecido, atributos obrigatórios e URLs já validadas. Escolha os canais, a moeda, o CEP de referência quando suportado e a forma de pagamento a comparar.

Separe produtos de maior impacto comercial dos demais. Essa classificação vai orientar a frequência das consultas e a prioridade dos alertas.

2. Descubra ofertas com buscas de produtos

A extração de listagem, chamada PLP (Product Listing Page), ajuda a encontrar anúncios e URLs que podem corresponder ao seu catálogo. Use a busca para descobrir novas ofertas e vendedores ao longo do tempo.

Este exemplo consulta a primeira página de uma busca no Mercado Livre. Configure GECKOAPI_KEY no ambiente do seu backend com a chave obtida no dashboard.

curl --fail-with-body --max-time 120 \
  --request POST 'https://api.geckoapi.com.br/v1/extract' \
  --header "Authorization: Bearer ${GECKOAPI_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "target": "mercadolivre.com.br",
    "type": "plp",
    "keyword": "samsung galaxy s25 ultra 512gb",
    "page": 1
  }'

A resposta inclui dados em data, com os resultados em data.items. Selecione candidatos pela URL e pelos atributos disponíveis. A primeira página representa uma amostra; percorra a paginação de acordo com a cobertura que sua análise exige. Consulte o contrato completo em Mercado Livre PLP.

3. Confirme produto e variação na página de detalhe

A PDP (Product Detail Page) consulta um produto específico. Ela permite aprofundar a comparação com os campos oferecidos pela fonte, como preço, pagamento à vista, seller e atributos.

Para comparar um anúncio de marketplace com a oferta da loja Samsung, por exemplo:

curl --fail-with-body --max-time 120 \
  --request POST 'https://api.geckoapi.com.br/v1/extract' \
  --header "Authorization: Bearer ${GECKOAPI_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "target": "samsung.com.br",
    "type": "pdp",
    "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p"
  }'

Na Samsung PDP, campos como data.price, data.cashPrice, data.ean e data.variants ajudam a identificar a oferta. Para fixar uma variação, use uma URL retornada em data.variants[].url. Sem um SKU explícito, o conector seleciona a primeira variação disponível, ou a primeira quando todas estão indisponíveis.

Use a URL do exemplo para entender o formato e substitua-a pelo produto que sua operação acompanha. Antes de comparar fontes, confirme que capacidade, cor, condição e demais atributos relevantes coincidem.

4. Inclua o frete quando houver suporte

Na Magalu e nas Casas Bahia, type: "quote" consulta frete por produto e CEP. Este exemplo usa o contrato da Magalu:

curl --fail-with-body --max-time 120 \
  --request POST 'https://api.geckoapi.com.br/v1/extract' \
  --header "Authorization: Bearer ${GECKOAPI_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "target": "magazineluiza.com.br",
    "type": "quote",
    "url": "https://www.magazineluiza.com.br/apple-iphone-15-128gb-azul-61-48mp-ios-5g/p/238034800/te/ip15/",
    "zipCode": "01001-000"
  }'

Esse é um exemplo independente de cotação: na sua rotina, envie a URL da oferta que está sendo comparada. Confira seller, opção de entrega, prazo e CEP antes de somar o frete ao preço. A documentação de Magalu Quote e Casas Bahia Quote detalha os respectivos retornos.

No Mercado Livre PDP, o CEP opcional é enviado na própria consulta de produto. A disponibilidade desses parâmetros depende da fonte; não adicione zipCode indiscriminadamente a todos os conectores.

5. Salve cada observação e execute a comparação

Agende as chamadas no seu backend ou na sua ferramenta de automação. A cada execução concluída, preserve o retorno e salve uma nova observação com data. Assim, você consegue calcular variações sem apagar o estado anterior.

O fluxo completo fica:

catálogo da sua loja
  → busca de ofertas nos canais escolhidos
  → confirmação de produto, variação e vendedor
  → preço e frete quando disponível
  → histórico com data e contexto
  → comparação e alerta para sua equipe

Se precisar aprofundar a arquitetura de descoberta e enriquecimento, veja o guia de monitoramento de preços de concorrentes com PLP e PDP.

Histórico de preços, alertas e indicadores para agir

O histórico de preços começa quando sua aplicação passa a guardar as coletas. Uma consulta atual não reconstrói automaticamente os valores praticados nos meses anteriores. Preserve cada observação para construir essa série ao longo do tempo.

Informação a salvar	Para que serve
Produto interno e atributos confirmados	Reunir ofertas equivalentes do mesmo item.
Fonte, URL, identificador da oferta e seller	Rastrear quem vendeu e onde o preço foi observado.
Preço, moeda e condição de pagamento	Comparar valores sob as mesmas condições.
Variação e quantidade por embalagem	Evitar misturar capacidades, tamanhos, voltagens e kits.
Frete, CEP e prazo, quando disponíveis	Reconstruir o contexto de entrega.
Disponibilidade e estado da coleta	Separar oferta indisponível de falha ou dado ausente.
Horário, identificador da requisição e resposta original	Investigar mudanças e revisar a normalização.

Quais alertas de preço merecem atenção?

Comece com poucas regras ligadas a decisões concretas:

Concorrente abaixo da sua faixa: uma oferta equivalente, disponível e com condições confirmadas cruza o limite definido pela equipe.
Queda persistente: o novo valor aparece em duas coletas válidas consecutivas, reduzindo alertas causados por uma leitura isolada.
Mudança no vendedor observado: o preço acompanha uma troca de seller; o time consegue avaliar a oferta com esse contexto.
Ruptura na concorrência: uma oferta antes disponível passa a indicar indisponibilidade, enquanto sua loja tem estoque.
Mudança no custo de entrega: o preço do produto permanece estável, mas frete ou prazo alteram sua competitividade.

Cada alerta deve mostrar produto, fonte, vendedor, valor anterior, valor atual, condição comparada, horário e link da oferta. Isso permite revisar a evidência antes de alterar uma campanha ou um preço.

Uma falha de extração exige tratamento operacional, como nova tentativa ou revisão da fonte. Ela não deve produzir automaticamente um alerta comercial de “preço caiu para zero” ou “concorrente sem estoque”.

Indicadores de monitoramento de preço

Para começar, acompanhe quatro medidas: percentual do catálogo com ofertas equivalentes validadas, idade da última coleta válida, proporção de produtos em que sua loja tem o menor total observado e diferença percentual para a oferta comparável escolhida.

Um índice simples de posicionamento é:

índice de preço = seu preço comparável / preço comparável do concorrente × 100

No exemplo inicial, 219 / 228,90 × 100 ≈ 95,7. Sua oferta está aproximadamente 4,3% abaixo daquele concorrente no cenário avaliado. O índice só faz sentido quando produto, moeda, disponibilidade e condições de compra são comparáveis.

Evite chamar o menor preço encontrado de “menor preço de toda a internet”. O resultado descreve as fontes, páginas e horários que sua rotina efetivamente observou.

Qual frequência usar e quanto custa o monitoramento de preço?

A frequência deve acompanhar a velocidade com que sua equipe consegue agir. Produtos em campanha podem precisar de várias consultas por dia; itens de baixa prioridade podem começar com uma coleta diária. Ajuste a rotina com base nas mudanças observadas e no orçamento disponível.

Para dimensionar a extração, conte ofertas monitoradas, pois um único SKU pode ter vários anúncios em cada canal. Considere também buscas, páginas adicionais e cotações de frete:

créditos estimados no período = soma de
  (chamadas de cada endpoint × custo em créditos daquele endpoint)

Em um cenário ilustrativo, 200 ofertas consultadas quatro vezes ao dia durante 30 dias geram 24.000 consultas de produto. Se 50 ofertas forem acompanhadas quatro vezes ao dia e as outras 150 apenas uma vez, o total cai para 10.500 consultas. A cobertura temporal muda, mas os produtos prioritários mantêm a frequência maior.

Esses totais não incluem buscas, frete ou novas tentativas, e não representam automaticamente a quantidade de créditos. O consumo varia por endpoint. Use a documentação das APIs, o guia de conta e créditos e a página de preços da GeckoAPI para montar o orçamento com os conectores escolhidos.

O custo operacional também inclui armazenamento, agendamento, revisão de equivalência e manutenção dos alertas. A API gerenciada permite concentrar o desenvolvimento nessas regras de negócio e na integração com seu BI ou ERP.

Monitoramento de preço na Black Friday: prepare o histórico antes da campanha

Durante uma campanha, o percentual de desconto anunciado responde apenas parte da pergunta. Para saber como a oferta se posiciona, compare o valor atual com o histórico que você coletou e com as ofertas equivalentes disponíveis no mesmo momento.

Comece a registrar preços antes da promoção. Preserve o preço de referência informado pela página como um campo próprio: ele não deve ser tratado automaticamente como o preço que você observou ontem, nem como prova de um desconto histórico.

Durante a Black Friday, uma rotina útil combina consultas mais frequentes dos produtos prioritários, comparação de frete para os CEPs escolhidos e revisão de alertas que afetem campanhas ativas. Depois, o histórico permite estudar duração das promoções, disponibilidade e mudanças por canal.

O mesmo método serve para datas sazonais, lançamentos e ações de curta duração. Quanto mais clara a condição de comparação, mais útil fica o relatório para a próxima decisão comercial.

Comece seu monitoramento de preço com a GeckoAPI

Escolha dez produtos relevantes, dois canais e uma decisão que você quer melhorar. Valide as primeiras ofertas, registre as condições e guarde uma sequência de coletas. A partir desse piloto, amplie a cobertura para novos produtos, fontes e frequências.

As APIs de ecommerce da GeckoAPI entregam os dados para você construir comparadores, painéis de pricing, alertas e integrações com seus sistemas. Explore o catálogo de APIs para ecommerce e marketplaces e crie sua conta para testar a integração.

Para continuar em uma fonte específica, leia o guia de monitoramento de preços no Mercado Livre ou a documentação de produtos da Shopee.

Perguntas frequentes sobre monitoramento de preço

Como fazer monitoramento de preço de concorrentes?

Defina produtos e canais, encontre ofertas equivalentes, consulte preço e condições de venda periodicamente e armazene cada observação. Compare os resultados com regras da sua operação. Com uma API de dados de ecommerce, você automatiza a coleta e integra o retorno ao seu histórico e sistema de alertas.

É possível monitorar Mercado Livre, Amazon e Shopee juntos?

Sim. A GeckoAPI oferece conectores para essas fontes no mesmo endpoint de extração. Cada uma tem seu próprio contrato de entrada e de resposta. Sua aplicação relaciona as ofertas ao mesmo produto e normaliza os campos que vão entrar na comparação.

A API entrega um histórico de preços pronto?

As consultas de extração apresentadas neste guia retornam dados observados na fonte. Para montar o histórico, sua aplicação precisa agendar consultas e salvar os resultados com data. O período disponível para análise depende de quando você começou a coletar e de quais observações preservou.

O monitoramento de preço funciona em tempo real?

Nas consultas deste guia, a atualização depende de quando sua rotina chama a API e de quanto tempo a extração leva. São observações periódicas. Defina a frequência necessária para seu caso e mostre no painel a data da última coleta válida, para que a equipe conheça a idade do dado.

Consigo incluir frete e preço por CEP?

Depende do conector. Magalu e Casas Bahia oferecem consultas de frete por URL e CEP; o Mercado Livre PDP aceita CEP opcional. Outras fontes podem não oferecer esse parâmetro. Consulte o contrato de cada endpoint e mantenha o CEP associado ao valor coletado.

Monitorar preços também altera os preços da minha loja?

As extrações fornecem dados para análise. Para reprecificar sua loja, você precisa implementar a integração com seu ERP ou plataforma de ecommerce e definir limites de margem, regras de alteração e critérios de revisão. O monitoramento pode alimentar essa decisão.

Posso testar antes de ampliar para todo o catálogo?

Sim. Crie uma conta no dashboard e use os créditos iniciais do teste para validar os conectores e produtos do seu caso. Confira o custo de cada endpoint na documentação e estime o volume necessário antes de ampliar a frequência e a cobertura.