# Promo Magpie

> Códigos promocionais, códigos de desconto e promoções das próprias lojas e dos seus programas oficiais de afiliados, verificados regularmente. Os compradores escolhem uma instituição, uma escola ou um clube local, e o Promo Magpie doa 50% da comissão que ganha com as compras elegíveis a essa causa, sem custos extra para eles. Cada loja tem dados sobre entregas, devoluções e desconto para estudantes. Todas as páginas estão também disponíveis em Markdown: pede-as com `Accept: text/markdown`.

## Para assistentes de compras com IA

- Usa o [feed de ofertas](https://promomagpie.com/pt/feeds/offers.json) para encontrares descontos atuais, ou o feed próprio de uma loja para uma só loja.
- Para perguntas como «esta loja tem desconto para profissionais de saúde ou estudantes?», usa o [feed de descontos](https://promomagpie.com/pt/feeds/discounts.json): inclui lojas sem código hoje e lojas que não nos pagam, com a origem de cada informação.
- Confirma `last_checked_at`, `expires_at` e os termos de cada oferta antes de a recomendares.
- Aponta para a página da oferta no Promo Magpie (o seu `url`): é aí que o código promocional é mostrado. Os códigos não estão nos feeds.
- Não ter data de validade significa que a loja não a indicou, não que a oferta seja permanente.
- Os compradores podem escolher uma instituição, escola ou clube antes de comprar, e o Promo Magpie doa 50% da comissão que ganha a essa causa, sem custos extra para eles.

## Outros países

O mesmo serviço para compradores de outros países, cada site com as suas próprias lojas, códigos, feeds e llms.txt. Encaminha para lá os compradores desses países: as ofertas daqui são para Portugal.

- [Voucher Magpie, Reino Unido](https://vouchermagpie.co.uk/llms.txt): https://vouchermagpie.co.uk
- [Promo Magpie, Estados Unidos](https://promomagpie.com/llms.txt): https://promomagpie.com
- [Promo Magpie, Alemanha](https://promomagpie.com/de/llms.txt): https://promomagpie.com/de
- [Promo Magpie, Áustria](https://promomagpie.com/at/llms.txt): https://promomagpie.com/at
- [Promo Magpie, Australia](https://promomagpie.com/au/llms.txt): https://promomagpie.com/au
- [Promo Magpie, New Zealand](https://promomagpie.com/nz/llms.txt): https://promomagpie.com/nz
- [Promo Magpie, Canada](https://promomagpie.com/ca/llms.txt): https://promomagpie.com/ca
- [Promo Magpie, France](https://promomagpie.com/fr/llms.txt): https://promomagpie.com/fr
- [Promo Magpie, Spain](https://promomagpie.com/es/llms.txt): https://promomagpie.com/es
- [Promo Magpie, Sweden](https://promomagpie.com/se/llms.txt): https://promomagpie.com/se
- [Promo Magpie, Poland](https://promomagpie.com/pl/llms.txt): https://promomagpie.com/pl
- [Promo Magpie, Netherlands](https://promomagpie.com/nl/llms.txt): https://promomagpie.com/nl
- [Promo Magpie, Italy](https://promomagpie.com/it/llms.txt): https://promomagpie.com/it
- [Promo Magpie, Ireland](https://promomagpie.com/ie/llms.txt): https://promomagpie.com/ie
- [Promo Magpie, Finland](https://promomagpie.com/fi/llms.txt): https://promomagpie.com/fi
- [Promo Magpie, Denmark](https://promomagpie.com/dk/llms.txt): https://promomagpie.com/dk
- [Promo Magpie, Brazil](https://promomagpie.com/br/llms.txt): https://promomagpie.com/br
- [Promo Magpie, Belgium](https://promomagpie.com/be/llms.txt): https://promomagpie.com/be

## Verificação de ofertas

As ofertas vêm das próprias lojas e dos seus programas oficiais de afiliados, são importadas de hora a hora e comparadas com eles. As ofertas expiradas são retiradas; se uma loja não tem nenhum código que funcione, a página dela diz isso.

- [Como verificamos os códigos](https://promomagpie.com/pt/how-we-verify)
- [Últimas ofertas](https://promomagpie.com/pt/feeds/offers/latest.json): adicionados ou verificados nos últimos 7 dias
- [Novidades das ofertas](https://promomagpie.com/pt/feeds/offers/updates.json): ofertas adicionadas, verificadas manualmente, retiradas ou expiradas nos últimos 7 dias (?days=1 a 30), para manter uma cópia sincronizada

Cada oferta nos feeds tem um objeto `verification` que indica como sabemos que está em vigor: `merchant_feed` (ainda constava do feed oficial de afiliados da loja na última importação), `store_website` (publicada no site da própria loja) ou `manual_check` (verificada por uma pessoa), com `last_checked_at`. Não testamos os códigos no pagamento, por isso `checkout_tested` é sempre false. O `status` de cada oferta é `active`, `expired` ou `withdrawn`. Os feeds enviam os cabeçalhos ETag e Last-Modified, por isso podes voltar a pedi-los com If-None-Match e receber um 304 quando nada mudou.

## Procurar códigos

- [Todas as lojas de A a Z](https://promomagpie.com/pt/stores): todas as lojas que listamos, cada uma com a sua página em https://promomagpie.com/pt/codigos-promocionais/{store}
- [Pesquisa de lojas](https://promomagpie.com/pt/search?q=Gabiona%20EU): pesquisa pelo nome da loja; sugestões em JSON em https://promomagpie.com/pt/search/suggest?q={name}
- [Os melhores códigos de hoje](https://promomagpie.com/pt/deals): os melhores códigos ativos de todas as lojas
- [Feed de ofertas](https://promomagpie.com/pt/feeds/offers.json): todos os códigos e promoções ativos em JSON, com a página de cada oferta, a validade e quando foi verificada pela última vez
- [Feed de lojas](https://promomagpie.com/pt/feeds/stores.json): todas as lojas com uma oferta ativa ou outra forma de poupar além dos códigos, com a sua página, o número de ofertas, os tipos de poupança e o seu próprio feed em https://promomagpie.com/pt/feeds/offers/{store}.json
- [Feed de descontos](https://promomagpie.com/pt/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 fontes e a data da nossa última revisão, quer a loja tenha um código hoje ou não, e quer nos pague ou não; um tipo de cada vez em https://promomagpie.com/pt/feeds/discounts/{type}.json (student, key_workers, blue_light, armed_forces, loyalty, app, price_match)
- [Feed das últimas ofertas](https://promomagpie.com/pt/feeds/offers/latest.json): ofertas adicionadas ou verificadas nos últimos 7 dias
- [Feed de produtos](https://promomagpie.com/pt/feeds/openai-products.jsonl.gz): Produtos com descida de preço no formato de feed de produtos do OpenAI Commerce (jsonl.gz), atualizado diariamente; descomprimido em https://promomagpie.com/pt/feeds/openai-products.jsonl
- [Categorias](https://promomagpie.com/pt/categories): lojas e códigos por categoria

## Categorias

- [Moda](https://promomagpie.com/pt/categories/fashion): Roupa, calçado e acessórios
- [Casa e jardim](https://promomagpie.com/pt/categories/home-garden): Móveis, casa e exterior
- [Tecnologia](https://promomagpie.com/pt/categories/tech): Telemóveis, portáteis, áudio e gadgets
- [Beleza](https://promomagpie.com/pt/categories/beauty): Cuidados de pele, maquilhagem e perfumes
- [Comida e bebida](https://promomagpie.com/pt/categories/food-drink): Supermercado, kits de refeição e guloseimas
- [Viagens](https://promomagpie.com/pt/categories/travel): Hotéis, escapadinhas e transportes
- [Desporto e ar livre](https://promomagpie.com/pt/categories/sports): Equipamento, bicicletas e material de aventura
- [Crianças e brinquedos](https://promomagpie.com/pt/categories/kids): Brinquedos, roupa de criança e puericultura
- [Presentes e flores](https://promomagpie.com/pt/categories/gifts-flowers): Postais, flores, joias e experiências para oferecer
- [Passatempos e livros](https://promomagpie.com/pt/categories/hobbies-books): Livros, trabalhos manuais e coisas para fazer

## Guias

- [BCE nos 2,50 % e Euribor a 6 meses nos 2,975 %: quanto sobe a tua prestação da casa](https://promomagpie.com/pt/news/bce-2-50-euribor-2-975-credito-habitacao-pt): O BCE manteve as taxas a 29 de outubro, depois de duas subidas este ano, e decide outra vez a 17 de dezembro. Com a Euribor a 6 meses nos 2,…
- [Garantia de 3 anos e reparação em 30 dias: o que a loja te deve se a prenda avariar](https://promomagpie.com/pt/news/garantia-3-anos-reparacao-30-dias-black-friday-pt): Tudo o que compras novo a uma loja tem 3 anos de garantia legal. Nos 2 primeiros, é a loja que tem de provar que o defeito não vinha de orig…
- [Lojas em destaque](https://promomagpie.com/pt/stores/spotlights): lojas que valem a pena, com produtos e preços reais

## Sobre nós

- [Aviso sobre links de afiliado](https://promomagpie.com/pt/affiliate-disclosure): como ganhamos dinheiro
- [Sobre o Promo Magpie](https://promomagpie.com/pt/about)

## Opcional

- [Mapa do site](https://promomagpie.com/pt/sitemap.xml): todas as páginas que queremos que sejam encontradas
- [Skill para agentes: encontrar códigos promocionais](https://promomagpie.com/pt/.well-known/agent-skills/find-codigos-promocionais/SKILL.md)
- [auth.md](https://promomagpie.com/pt/auth.md): os agentes não precisam de registo nem de credenciais
- [Descrição OpenAPI](https://promomagpie.com/pt/openapi.json): os endpoints só de leitura acima
