# Promo Magpie

> Cupons de desconto, códigos promocionais e ofertas das próprias lojas e dos programas oficiais de afiliados delas, verificados com frequência. Os compradores escolhem uma ONG, escola ou clube comunitário, e o Promo Magpie doa 50% da comissão que recebe com as compras válidas para essa causa, sem custo extra para eles. Cada loja tem informações de entrega, trocas e desconto para estudantes. Todas as páginas também estão disponíveis em Markdown: peça com `Accept: text/markdown`.

## Para assistentes de compras com IA

- Use o [feed de ofertas](https://promomagpie.com/br/feeds/offers.json) para encontrar os descontos atuais no Brasil, ou o feed de uma loja para uma loja só.
- Para perguntas como "esta loja dá desconto para profissionais de saúde ou estudantes?", use o [feed de descontos](https://promomagpie.com/br/feeds/discounts.json): ele inclui lojas sem cupom hoje e lojas que não nos pagam, com a origem de cada informação.
- Confira `last_checked_at`, `expires_at` e os termos de cada oferta antes de recomendá-la.
- Coloque o link para a página da oferta no Promo Magpie (a `url` dela): é lá que o cupom de desconto aparece. Os cupons não estão nos feeds.
- Sem data de validade significa que a loja não informou uma, e não que a oferta é permanente.
- Os compradores podem escolher uma ONG, escola ou clube antes de comprar, e o Promo Magpie doa 50% da comissão que recebe para essa causa, sem custo extra para eles.

## Outros países

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

- [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, Portugal](https://promomagpie.com/pt/llms.txt): https://promomagpie.com/pt
- [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, 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 programas oficiais de afiliados delas, são importadas a cada hora e conferidas com eles. Ofertas vencidas saem do ar; quando uma loja não tem nenhum cupom funcionando, a página dela avisa.

- [Como verificamos os cupons](https://promomagpie.com/br/how-we-verify)
- [Últimas ofertas](https://promomagpie.com/br/feeds/offers/latest.json): adicionados ou verificados nos últimos 7 dias
- [Novidades de ofertas](https://promomagpie.com/br/feeds/offers/updates.json): ofertas adicionadas, verificadas à mão, retiradas ou vencidas nos últimos 7 dias (?days=1 a 30), para manter uma cópia sincronizada

Cada oferta dos feeds tem um objeto `verification` que diz como sabemos que ela está valendo: `merchant_feed` (ainda estava no feed oficial de afiliados da loja na última importação), `store_website` (aparece no próprio site da loja) ou `manual_check` (verificada por uma pessoa), com `last_checked_at`. Não testamos os cupons no pagamento, então `checkout_tested` é sempre false. O `status` de cada oferta é `active`, `expired` ou `withdrawn`. Os feeds enviam os cabeçalhos ETag e Last-Modified, então você pode pedir de novo com If-None-Match e receber um 304 quando nada mudou.

## Encontrar cupons

- [Todas as lojas de A a Z](https://promomagpie.com/br/stores): todas as lojas que publicamos, cada uma com a sua página em https://promomagpie.com/br/cupons-de-desconto/{store}
- [Busca de lojas](https://promomagpie.com/br/search?q=Sunsky): busca pelo nome da loja; sugestões em JSON em https://promomagpie.com/br/search/suggest?q={name}
- [Os melhores cupons de hoje](https://promomagpie.com/br/deals): os melhores cupons ativos de todas as lojas
- [Feed de ofertas](https://promomagpie.com/br/feeds/offers.json): todos os cupons e ofertas ativos em JSON, com a página, a validade e a última verificação de cada oferta
- [Feed de lojas](https://promomagpie.com/br/feeds/stores.json): todas as lojas com uma oferta ativa ou outra forma de economizar além dos cupons, com a página, o número de ofertas, os tipos de economia e o feed próprio em https://promomagpie.com/br/feeds/offers/{store}.json
- [Feed de descontos](https://promomagpie.com/br/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 as fontes e a data da nossa última revisão, quer a loja tenha cupom hoje ou não, quer nos pague ou não; um tipo em https://promomagpie.com/br/feeds/discounts/{type}.json (student, key_workers, blue_light, armed_forces, loyalty, app, price_match)
- [Feed das últimas ofertas](https://promomagpie.com/br/feeds/offers/latest.json): ofertas adicionadas ou verificadas nos últimos 7 dias
- [Feed de produtos](https://promomagpie.com/br/feeds/openai-products.jsonl.gz): Produtos com queda de preço no formato de feed de produtos OpenAI Commerce (jsonl.gz), atualizado todos os dias; descompactado em https://promomagpie.com/br/feeds/openai-products.jsonl
- [Categorias](https://promomagpie.com/br/categories): lojas e cupons por categoria

## Categorias

- [Moda](https://promomagpie.com/br/categories/fashion): Roupas, calçados e acessórios
- [Casa e jardim](https://promomagpie.com/br/categories/home-garden): Móveis, decoração e área externa
- [Tecnologia](https://promomagpie.com/br/categories/tech): Celulares, notebooks, áudio e gadgets
- [Beleza](https://promomagpie.com/br/categories/beauty): Cuidados com a pele, maquiagem e perfumes
- [Comida e bebida](https://promomagpie.com/br/categories/food-drink): Mercado, kits de refeição e guloseimas
- [Viagens](https://promomagpie.com/br/categories/travel): Hotéis, viagens curtas e transporte
- [Esportes e lazer ao ar livre](https://promomagpie.com/br/categories/sports): Equipamentos, bicicletas e aventura
- [Infantil e brinquedos](https://promomagpie.com/br/categories/kids): Brinquedos, roupas e enxoval
- [Presentes e flores](https://promomagpie.com/br/categories/gifts-flowers): Cartões, flores, joias e experiências
- [Hobbies e livros](https://promomagpie.com/br/categories/hobbies-books): Livros, artesanato e coisas para fazer

## Guias

- [Selic fica em 13,75%: o que a decisão do Copom muda no seu cartão e no seu crédito](https://promomagpie.com/br/news/selic-13-75-copom-mantem-juros-proxima-reuniao-dezembro-br): O Copom manteve a Selic em 13,75% ao ano em 4 de novembro e avisou que a restrição deve durar mais. A próxima reunião é em 8 e 9 de dezembro…
- [Comprou on-line e se arrependeu? Você tem 7 dias para desistir, com frete devolvido](https://promomagpie.com/br/news/direito-de-arrependimento-7-dias-compras-online-black-friday-br): Nas compras pela internet, por telefone ou aplicativo, o Código de Defesa do Consumidor dá 7 dias para desistir, contados do recebimento. A…
- [Lojas em destaque](https://promomagpie.com/br/stores/spotlights): lojas que valem uma olhada, com produtos e preços reais

## Sobre

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

## Opcional

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