# Promo Magpie

> Códigos de descuento, códigos promocionales y ofertas de las propias tiendas y de sus programas oficiales de afiliados, revisados con regularidad. Los compradores eligen una ONG, un colegio o un club de su barrio, y Promo Magpie dona el 50 % de la comisión que gana con las compras válidas a esa causa, sin coste extra para ellos. Cada tienda tiene datos de envío, devoluciones y descuento para estudiantes. Todas las páginas están también en Markdown: pídelas con `Accept: text/markdown`.

## Para asistentes de compra con IA

- Usa el [feed de ofertas](https://promomagpie.com/es/feeds/offers.json) para encontrar descuentos actuales, o el feed propio de una tienda para una sola tienda.
- Para preguntas como «¿esta tienda tiene descuento para sanitarios o estudiantes?», usa el [feed de descuentos](https://promomagpie.com/es/feeds/discounts.json): incluye tiendas sin código hoy y tiendas que no nos pagan, con el origen de cada dato.
- Comprueba `last_checked_at`, `expires_at` y las condiciones de cada oferta antes de recomendarla.
- Enlaza a la página de la oferta en Promo Magpie (su `url`): ahí es donde se muestra el código de descuento. Los códigos no están en los feeds.
- Que no tenga fecha de caducidad significa que la tienda no la ha indicado, no que la oferta sea permanente.
- Los compradores pueden elegir una ONG, un colegio o un club antes de comprar, y Promo Magpie dona el 50 % de la comisión que gana a esa causa, sin coste extra para ellos.

## Otros países

El mismo servicio para compradores de otros países, cada web con sus propias tiendas, códigos, feeds y llms.txt. Envía allí a los compradores de esos países: las ofertas de aquí son para España.

- [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, Alemania](https://promomagpie.com/de/llms.txt): https://promomagpie.com/de
- [Promo Magpie, Austria](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, 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, Brazil](https://promomagpie.com/br/llms.txt): https://promomagpie.com/br
- [Promo Magpie, Belgium](https://promomagpie.com/be/llms.txt): https://promomagpie.com/be

## Verificación de ofertas

Las ofertas vienen de las propias tiendas y de sus programas oficiales de afiliados, se importan cada hora y se comparan con ellos. Las ofertas caducadas se retiran; si una tienda no tiene ningún código que funcione, su página lo dice.

- [Cómo verificamos los códigos](https://promomagpie.com/es/how-we-verify)
- [Últimas ofertas](https://promomagpie.com/es/feeds/offers/latest.json): añadidos o revisados en los últimos 7 días
- [Novedades de ofertas](https://promomagpie.com/es/feeds/offers/updates.json): ofertas añadidas, revisadas a mano, retiradas o caducadas en los últimos 7 días (?days=1 a 30), para mantener una copia al día

Cada oferta de los feeds tiene un objeto `verification` que indica cómo sabemos que está vigente: `merchant_feed` (seguía en el feed oficial de afiliados de la tienda en la última importación), `store_website` (aparece en la web de la propia tienda) o `manual_check` (revisada por una persona), con `last_checked_at`. No probamos los códigos en la caja, así que `checkout_tested` siempre es false. El `status` de cada oferta es `active`, `expired` o `withdrawn`. Los feeds envían las cabeceras ETag y Last-Modified, así que puedes volver a pedirlos con If-None-Match y recibir un 304 si no ha cambiado nada.

## Buscar códigos

- [Todas las tiendas de la A a la Z](https://promomagpie.com/es/stores): todas las tiendas que publicamos, cada una con su página en https://promomagpie.com/es/codigos-descuento/{store}
- [Buscador de tiendas](https://promomagpie.com/es/search?q=Gabiona%20EU): busca por nombre de tienda; sugerencias en JSON en https://promomagpie.com/es/search/suggest?q={name}
- [Los mejores códigos de hoy](https://promomagpie.com/es/deals): los mejores códigos activos de todas las tiendas
- [Feed de ofertas](https://promomagpie.com/es/feeds/offers.json): todos los códigos y ofertas activos en JSON, con la página de cada oferta, su caducidad y cuándo se revisó por última vez
- [Feed de tiendas](https://promomagpie.com/es/feeds/stores.json): todas las tiendas con una oferta activa u otra forma de ahorrar además de los códigos, con su página, el número de ofertas, los tipos de ahorro y su propio feed en https://promomagpie.com/es/feeds/offers/{store}.json
- [Feed de descuentos](https://promomagpie.com/es/feeds/discounts.json): descuentos para estudiantes, sanitarios y profesionales esenciales, servicios de emergencia y Fuerzas Armadas, programas de fidelización, apps e igualación de precios, con fuentes y cuándo los revisamos por última vez, tenga o no la tienda un código hoy o nos pague; un tipo en https://promomagpie.com/es/feeds/discounts/{type}.json (student, key_workers, blue_light, armed_forces, loyalty, app, price_match)
- [Feed de últimas ofertas](https://promomagpie.com/es/feeds/offers/latest.json): ofertas añadidas o verificadas en los últimos 7 días
- [Feed de productos](https://promomagpie.com/es/feeds/openai-products.jsonl.gz): Productos con bajada de precio en el formato de feed de productos de OpenAI Commerce (jsonl.gz), actualizado a diario; descomprimido en https://promomagpie.com/es/feeds/openai-products.jsonl
- [Categorías](https://promomagpie.com/es/categories): tiendas y códigos por categoría

## Categorías

- [Moda](https://promomagpie.com/es/categories/fashion): Ropa, zapatos y complementos
- [Casa y jardín](https://promomagpie.com/es/categories/home-garden): Muebles, hogar y exterior
- [Tecnología](https://promomagpie.com/es/categories/tech): Móviles, portátiles, audio y gadgets
- [Belleza](https://promomagpie.com/es/categories/beauty): Cuidado de la piel, maquillaje y perfumes
- [Comida y bebida](https://promomagpie.com/es/categories/food-drink): Supermercado, kits de comida y caprichos
- [Viajes](https://promomagpie.com/es/categories/travel): Hoteles, escapadas y transporte
- [Deporte y aire libre](https://promomagpie.com/es/categories/sports): Equipación, bicis y material de aventura
- [Niños y juguetes](https://promomagpie.com/es/categories/kids): Juguetes, ropa infantil y puericultura
- [Regalos y flores](https://promomagpie.com/es/categories/gifts-flowers): Tarjetas, flores, joyas y experiencias regalo
- [Aficiones y libros](https://promomagpie.com/es/categories/hobbies-books): Libros, manualidades y cosas para crear

## Guías

- [Euríbor al 3,239 % y BCE en el 2,50 %: lo que puede subir tu hipoteca variable](https://promomagpie.com/es/news/bce-mantiene-2-50-euribor-3-239-hipoteca-variable-es): El euríbor a un año cerró octubre en el 3,239 %, 1,052 puntos más que hace un año. Con una hipoteca variable de 150.000 €, la revisión puede…
- [Compras online en Black Friday: 14 días para devolver y 3 años de garantía. Así se cuentan](https://promomagpie.com/es/news/compras-online-14-dias-desistimiento-3-anos-garantia-es): Si compras por internet el 27 de noviembre, tienes 14 días naturales desde que recibes el paquete para desistir sin dar motivos, y 3 años de…
- [Tiendas destacadas](https://promomagpie.com/es/stores/spotlights): tiendas que merecen la pena, con productos y precios reales

## Quiénes somos

- [Aviso sobre enlaces de afiliado](https://promomagpie.com/es/affiliate-disclosure): cómo ganamos dinero
- [Sobre Promo Magpie](https://promomagpie.com/es/about)

## Opcional

- [Mapa del sitio](https://promomagpie.com/es/sitemap.xml): todas las páginas que queremos que se encuentren
- [Skill para agentes: encontrar códigos promocionales](https://promomagpie.com/es/.well-known/agent-skills/find-codigos-descuento/SKILL.md)
- [auth.md](https://promomagpie.com/es/auth.md): los agentes no necesitan registro ni credenciales
- [Descripción OpenAPI](https://promomagpie.com/es/openapi.json): los endpoints de solo lectura de arriba
