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.