Saltar para o conteúdo

Feeds de dados

Todos os códigos e promoções ativos do Promo Magpie, em JSON gratuito para assistentes de IA, motores de pesquisa e programadores.

Última atualização: 16 de novembro de 2026

Os feeds

  • Lojas (/feeds/stores.json): todas as lojas com ofertas ativas ou outra forma de poupar além dos códigos, a sua página, quantas ofertas tem, que poupanças oferece e uma ligação para o seu próprio feed. Começa por aqui.
  • Descontos (/feeds/discounts.json): descontos para estudantes, profissionais de saúde e profissionais essenciais, profissionais de emergência e Forças Armadas, programas de fidelização, apps e igualação de preços, com a origem de cada um e a data da nossa última revisão. Inclui lojas sem código hoje e lojas que não nos pagam. Um tipo de cada 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 códigos e as promoções ativos de uma única loja, poucos kilobytes cada. A parte da loja é igual ao endereço da sua página, por isso /codigos-promocionais/sodastream tem o seu feed em /feeds/offers/sodastream.json.
  • Últimas ofertas (/feeds/offers/latest.json): ofertas adicionadas ou verificadas manualmente nos últimos 7 dias, das mais recentes para as mais antigas.
  • Novidades das ofertas (/feeds/offers/updates.json): ofertas adicionadas, verificadas manualmente, retiradas ou expiradas nos últimos 7 dias (acrescenta ?days=1 a 30 para outro período), das mais recentes para as mais antigas, cada uma com o que mudou e quando. Usa-o para manter a tua própria cópia sincronizada sem descarregar tudo.
  • Todas as ofertas (/feeds/offers.json): todo o catálogo num só ficheiro, com cerca de 2,5 MB.
  • Produtos com descida de preço (/feeds/openai-products.jsonl.gz): produtos em promoção, no formato de feed de produtos do OpenAI Commerce, atualizado diariamente.

Os mesmos feeds estão listados em llms.txt e descritos em Descrição OpenAPI. Não é preciso chave nem registo.

O que diz cada oferta

  • Título, tipo e desconto: o que é a oferta, se é um código ou uma promoção direta, e a poupança (como «10 % de desconto» ou «Portes grátis»).
  • Termos: compra mínima, exclusões e outras condições, tal como a loja ou o seu programa de afiliados as indica.
  • Datas: quando começa e termina, se a loja nos disse. Sem data de fim quer dizer que não foi indicada, não que dure para sempre.
  • Estado: active (ativa), expired (passou a data de fim) ou withdrawn (já não está no feed, ou foi retirada).
  • Verificação: como sabemos que está em vigor e quando a verificámos pela última vez: merchant_feed (continua no feed oficial de afiliados da loja), store_website (aparece no site da própria loja) ou manual_check (verificada por uma pessoa). Não testamos os códigos no pagamento, por isso checkout_tested é sempre false.
  • País e moeda: PT e EUR, no bloco de editor de cada feed: todas as ofertas aqui são para compradores deste país, com preços na sua moeda. Os nossos sites de outros países têm os seus próprios feeds.
  • Link: a oferta na página da respetiva loja.

Os códigos não estão nos feeds. Os compradores obtêm cada código na página da loja, através do nosso link de seguimento, que é como ganhamos a comissão que partilhamos com a instituição, clube ou escola que escolhem. Por favor, faz link para a oferta em vez de citar o código.

Quão atualizado está

As ofertas vêm das próprias lojas e dos seus programas oficiais de afiliados, que importamos de hora a hora; os feeds são gerados de novo no máximo de hora a hora (a cada 15 minutos para lojas individuais e para as últimas ofertas). Retiramos as ofertas expiradas e, se uma loja não tem nenhum código que funcione, a página dela diz isso em vez de mostrar códigos antigos. Como verificamos os códigos explica o resto.

Utilizar os feeds

  • Podes lê-los, guardá-los em cache e citá-los. Pedimos só que ligues cada oferta à respetiva página no Promo Magpie.
  • Todos os feeds enviam os cabeçalhos ETag e Last-Modified. Volta a pedir com If-None-Match ou If-Modified-Since e recebes uma resposta curta 304 até haver alterações. As respostas são comprimidas (Brotli ou gzip) se o pedires.
  • Confirma os termos e a data de fim de uma oferta antes de a recomendares.
  • As lojas só aparecem se as promovermos: nada de lojas para adultos, apostas, álcool ou vape, e só ofertas com preços em euros.
  • Doamos 50% da comissão que ganhamos à causa escolhida pelo comprador, sem qualquer custo extra para ele. Como ganhamos dinheiro tem os pormenores.

Tens perguntas ou precisas de algo que os feeds não têm? Contacta-nos.

Escolhe uma instituição ou um clube para apoiar · damos-lhe 50% da nossa comissão, sem qualquer custo para tiEscolher