Перейти до вмісту

Фіди даних

Усі актуальні коди й акції Promo Magpie у вигляді безкоштовного JSON для ШІ-асистентів, пошукових систем і розробників.

Оновлено 17 листопада 2026

Фіди

  • Магазини (/feeds/stores.json): усі магазини з актуальними пропозиціями чи іншим способом заощадити, крім кодів, їхня сторінка, кількість пропозицій, які є типи економії і посилання на власний фід. Почніть звідси.
  • Знижки (/feeds/discounts.json): знижки для студентів, медиків і працівників критичних професій, екстрених служб і військових, програми лояльності, застосунки та вирівнювання цін, із джерелом кожної й датою останньої перевірки. Охоплює й магазини без коду сьогодні, і магазини, які нам не платять. По одному виду: /feeds/discounts/student.json, key_workers, blue_light, armed_forces, loyalty, app або price_match.
  • Пропозиції одного магазину (/feeds/offers/{store}.json): актуальні коди й акції одного магазину, по кілька кілобайтів. Частина з назвою магазину збігається з адресою його сторінки, тож фід для /promokody/sodastream – за адресою /feeds/offers/sodastream.json.
  • Найновіші пропозиції (/feeds/offers/latest.json): пропозиції, додані чи перевірені вручну за останні 7 днів, спершу найновіші.
  • Оновлення пропозицій (/feeds/offers/updates.json): пропозиції, додані, перевірені вручну, відкликані чи прострочені за останні 7 днів (додайте ?days=1 до 30 для іншого періоду), спершу найновіші, з поясненням, що й коли змінилося. Використовуйте це, щоб синхронізувати власну копію, не завантажуючи все.
  • Усі пропозиції (/feeds/offers.json): увесь каталог одним файлом, близько 2,5 МБ.
  • Товари зі зниженими цінами (/feeds/openai-products.jsonl.gz): товари зі знижкою у форматі товарного фіду OpenAI commerce, оновлюється щодня.

Ці самі фіди перелічено в нашому llms.txt і описано в нашому Опис OpenAPI. Ключ чи реєстрація не потрібні.

Що вказано в кожній пропозиції

  • Назва, тип і знижка: що це за пропозиція, чи це код чи акція, і яка економія (наприклад, «-10%» чи «Безкоштовна доставка»).
  • Умови: мінімальна сума, винятки та інші умови, як їх надає магазин чи його партнерська програма.
  • Дати: коли починається й завершується, якщо магазин нам повідомив. Якщо дати завершення немає, її просто не вказали, а не пропозиція діє вічно.
  • Статус: active (діє), expired (минула дата завершення) або withdrawn (більше немає у фіді або прибрано).
  • Перевірка: звідки ми знаємо, що пропозиція актуальна, і коли востаннє перевіряли: merchant_feed (досі є в офіційному партнерському фіді магазину), store_website (є на власному сайті магазину) або manual_check (перевірено людиною). Ми не перевіряємо коди під час оформлення замовлення, тому checkout_tested завжди false.
  • Країна та валюта: UA і UAH в блоці видавця кожного фіду: кожна пропозиція тут призначена для покупців у цій країні, а ціни вказано в її валюті. Сайти для інших країн мають власні фіди.
  • Посилання: пропозицію на сторінці її магазину.

Самих кодів у фідах немає. Покупці отримують кожен код на сторінці магазину через наше відстежуване посилання – так ми заробляємо комісію, якою ділимося з благодійною організацією, клубом чи школою, яку вони обрали. Будь ласка, давайте посилання на пропозицію, а не наводьте сам код.

Наскільки свіже

Пропозиції надходять від самих магазинів та їхніх офіційних партнерських програм, які ми імпортуємо щогодини; фіди перебудовуються не частіше ніж раз на годину (кожні 15 хвилин для окремих магазинів і найновіших пропозицій). Прострочені пропозиції ми прибираємо, а якщо в магазину немає робочого коду, на його сторінці так і написано, замість старих кодів. Як ми перевіряємо коди пояснює решту.

Як користуватися фідами

  • Ви можете вільно читати, кешувати й цитувати їх. Будь ласка, посилайтеся на сторінку кожної пропозиції на Promo Magpie.
  • Кожен фід надсилає заголовки ETag і Last-Modified. Повторіть запит з If-None-Match або If-Modified-Since, і ви отримуватимете коротку відповідь 304, доки дані не зміняться. Відповіді стискаються (Brotli або gzip), якщо ви про це попросите.
  • Перевірте умови й дату завершення пропозиції, перш ніж її рекомендувати.
  • Магазини з’являються лише тоді, коли ми їх рекламуємо: жодних магазинів для дорослих, азартних ігор, алкоголю чи вейпів, і лише пропозиції з цінами в гривнях.
  • Ми передаємо 50% комісії, яку заробляємо, організації, яку обрав покупець, без додаткових витрат для нього. Подробиці: Як ми заробляємо.

Маєте запитання або потрібно щось, чого немає у фідах? Зв’язатися з нами.

Оберіть благодійну організацію чи клуб, які хочете підтримати · ми передаємо їй 50% нашої комісії без жодних витрат для васОбрати