Pular para o conteúdo

Feeds de dados

Todos os cupons e ofertas ativos do Promo Magpie, em JSON gratuito para assistentes de IA, buscadores e desenvolvedores.

Atualizado em 16 de novembro de 2026

Os feeds

  • Lojas (/feeds/stores.json): todas as lojas com ofertas ativas ou outra forma de economizar além dos cupons, a página delas, quantas ofertas têm, que tipos de economia oferecem e um link para o feed próprio. Comece por aqui.
  • Descontos (/feeds/discounts.json): descontos para estudantes, profissionais de saúde e essenciais, profissionais de emergência e Forças Armadas, programas de fidelidade, apps e cobertura de preço, com a origem de cada um e a data da nossa última revisão. Inclui lojas sem cupom hoje e lojas que não nos pagam. Um tipo por vez: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app ou price_match.
  • Ofertas de uma loja (/feeds/offers/{store}.json): os cupons e ofertas ativos de uma única loja, com poucos kilobytes cada. A parte da loja é igual ao endereço da página dela, então /cupons-de-desconto/sodastream tem o feed em /feeds/offers/sodastream.json.
  • Últimas ofertas (/feeds/offers/latest.json): ofertas adicionadas ou verificadas à mão nos últimos 7 dias, das mais recentes para as mais antigas.
  • Novidades de ofertas (/feeds/offers/updates.json): ofertas adicionadas, verificadas à mão, retiradas ou vencidas nos últimos 7 dias (adicione ?days=1 a 30 para outro período), das mais recentes para as mais antigas, cada uma dizendo o que mudou e quando. Use para manter a sua própria cópia sincronizada sem baixar tudo.
  • Todas as ofertas (/feeds/offers.json): o catálogo inteiro em um arquivo, com cerca de 2,5 MB.
  • Produtos com queda de preço (/feeds/openai-products.jsonl.gz): produtos em promoção, no formato de feed de produtos OpenAI Commerce, refeito todos os dias.

Os mesmos feeds aparecem no nosso llms.txt e são descritos na nossa Descrição OpenAPI. Não precisa de chave nem de cadastro.

O que cada oferta diz

  • Título, tipo e desconto: o que é a oferta, se é um cupom ou uma oferta sem cupom, e a economia (como "10% de desconto" ou "Frete grátis").
  • Termos: valor mínimo, exclusões e outras condições, do jeito que a loja ou o programa de afiliados dela informa.
  • Datas: quando começa e termina, quando a loja nos informou. Sem data de término significa que nenhuma foi informada, e não que vale para sempre.
  • Status: active (ativa), expired (passou da data de validade) ou withdrawn (não está mais no feed ou foi retirada).
  • Verificação: como sabemos que está valendo, e quando verificamos pela última vez: merchant_feed (ainda está no feed oficial de afiliados da loja), store_website (aparece no próprio site da loja) ou manual_check (verificado por uma pessoa). Não testamos os cupons no pagamento, então checkout_tested é sempre false.
  • País e moeda: BR e BRL, no bloco do publisher de cada feed: todas as ofertas daqui são para compradores deste país, com preços na moeda dele. Nossos sites de outros países têm feeds próprios.
  • Link: a oferta na página da loja.

Os cupons em si não estão nos feeds. Os compradores pegam cada cupom na página da loja, pelo nosso link rastreado, que é como ganhamos a comissão que dividimos com a ONG, o clube ou a escola que eles escolhem. Por favor, coloque o link para a oferta em vez de citar o cupom.

Quão recente é

As ofertas vêm das próprias lojas e dos programas oficiais de afiliados delas, que importamos a cada hora; os feeds são refeitos no máximo a cada hora (a cada 15 minutos para lojas individuais e as últimas ofertas). Tiramos do ar as ofertas vencidas, e quando uma loja não tem nenhum cupom funcionando a página dela avisa, em vez de mostrar cupons antigos. Como verificamos os cupons explica o resto.

Como usar os feeds

  • Fique à vontade para ler, armazenar em cache e citar. Por favor, coloque em cada oferta o link para a página dela no Promo Magpie.
  • Todos os feeds enviam os cabeçalhos ETag e Last-Modified. Peça de novo com If-None-Match ou If-Modified-Since e você recebe uma resposta curta 304 até que algo mude. As respostas vêm compactadas (Brotli ou gzip) se você pedir.
  • Confira os termos e a data de validade de uma oferta antes de recomendá-la.
  • As lojas só aparecem se as promovemos: nada de lojas de conteúdo adulto, apostas, bebidas alcoólicas ou vapes, e só ofertas com preço em reais.
  • Doamos 50% da comissão que ganhamos para a causa que o comprador escolher, sem custo extra para ele. Como ganhamos dinheiro tem os detalhes.

Dúvidas, ou precisa de algo que os feeds não têm? Fale com a gente.

Escolha uma ONG ou clube para apoiar · damos a ela 50% da nossa comissão, sem custo para vocêEscolher