За разработчици — JSON API и open data

JSON API скоро

API-то ще бъде публикувано в Q3/2026 след пълно покриване на пайплайна с пресечени данни и преглед от фармацевт. Планираните крайни точки:

Метод	Път	Описание
`GET`	`/api/v1/drugs?q=...`	Търсене по търговско име, INN, ATC, производител
`GET`	`/api/v1/drugs/{slug}`	Пълен запис на конкретен продукт
`GET`	`/api/v1/substances/{inn}`	Активна съставка + всички продукти
`GET`	`/api/v1/atc/{code}`	ATC категория + членове
`POST`	`/api/v1/interactions/check`	Проверка на взаимодействия между N лекарства
`GET`	`/api/v1/prices/{slug}`	Текущи цени от 5+ аптеки (ако са достъпни)
`GET`	`/api/v1/changes?since=...`	Лог на промените (ново лекарство, обновена листовка, recall)

Условия

Безплатно за некомерсиална употреба (пациентски приложения, обучителни ресурси, академични проекти).
Лимит: 60 заявки/мин за анонимни клиенти; 600 заявки/мин с безплатен API ключ.
Комерсиалните клиенти (EHR, телемед, аптечни системи) подписват SLA и достъпват със заплатен ключ.
Атрибуция: всеки потребител на API-то трябва да показва връзка към listovki.bg в крайния продукт и да цитира оригиналния източник на ИАЛ/EMA, когато показва клинично съдържание.

Open data в GitHub скоро

Ежедневен structured-data export на цялата база (без AI-генерираните текстове) ще се публикува в публично GitHub репо listovki/open-data под лиценз CC BY-NC 4.0.

Файлове в репото:

drugs.csv — една ред за всеки лекарствен продукт (slug, trade_name, INN, ATC, форма, концентрация, производител, ИАЛ рег.№, прескрипционен статус, leaflet_pdf_url)
substances.csv — активни вещества по INN с ATC mapping
atc.csv — пълната WHO ATC класификация (5 нива)
manufacturers.csv — притежатели на разрешение за употреба
interactions.csv — двойки активни вещества + изтеглена тежест
changes.jsonl — append-only лог на промените

Версиите се таггват с дата (2026-05-26), хешове на файловете се пишат в SHA256SUMS. Schemaпром се документира в CHANGELOG.md.

Sitemap + IndexNow

Sitemap-индекс: /sitemap-index.xml — актуализира се след всеки rebuild. Подкрепяме IndexNow за Bing/Yandex.

Schema.org markup

Всяка клинична страница носи:

Drug — име, INN, форма, концентрация, статут на отпускане
MedicalWebPage с reviewedBy Person — името и ЛИК на прегледалия фармацевт
FAQPage — често задавани въпроси, ако са налични
BreadcrumbList — навигационна пътека

Проверете с Google Rich Results Test.

Кога ще е готово

Q2/2026 — публичен read-only API в бета (без ключове, rate-limit 60/min).
Q3/2026 — open-data репо в GitHub с първа версия.
Q4/2026 — SLA-обвързано B2B ниво за EHR / телемед клиенти.