Последна синхронизация с ИАЛ:

listovki.bg Български справочник за лекарствените продукти

Developer API

За разработчици

Структурираните данни от listovki.bg са достъпни чрез read-only JSON API. Достъпът е безплатен, но по заявка — издаваме ключ на всеки проект, който ни каже за какво ще ги ползва. Целта: по-добри български здравно-технологични продукти.

Лекарствени продукти
10 366
Активни вещества
2679
ATC кодове
1958
Източници
5

JSON API

API-то е достъпно по заявка. Данните са безплатни, но не са отворени за анонимен достъп — издаваме ключ на всеки, който ни каже какво строи. Пишете на redaktsiya@listovki.bg с кратко описание на проекта.

Всяка заявка носи ключа в хедър:

Authorization: Bearer lstv_…

Без валиден ключ всяка от точките по-долу връща 401. Изброени са само точките, които съществуват днес.

МетодПътОписание
GET/api/v1/search.json?q=…Търсене по търговско име или продукт. Работи и на кирилица („нурофен“), и на латиница.
GET/api/v1/drugs.jsonКаталог на лекарствените продукти. Странициране с ?limit= (макс. 1000) и ?offset=.
GET/api/v1/drugs/{slug}.jsonПълен запис на конкретен продукт
GET/api/v1/substances.jsonАктивни вещества (INN) с ATC кодове
GET/api/v1/products.jsonАптечни продукти с цени (каталог)
GET/api/v1/products/{slug}.jsonПродукт + офертите от всички проследявани аптеки
GET/api/v1/interactions/{inn-a}-vs-{inn-b}.jsonВзаимодействие между две активни вещества. Редът няма значение.

Пример:

curl -H "Authorization: Bearer lstv_…" \
     "https://listovki.bg/api/v1/search.json?q=ибупрофен"

Условия

  • Безплатно, но по заявка. Не таксуваме достъпа. Ключът служи да знаем кой ползва данните и да можем да се свържем при промяна в схемата.
  • Масовите тегления правете чрез ?limit=&offset=, а не с паралелни заявки. Ключ, който натоварва прекомерно, се отзовава.
  • Атрибуция: показвайте връзка към listovki.bg в крайния продукт и цитирайте оригиналния източник (ИАЛ / EMA), когато показвате клинично съдържание.
  • Данните се доставят „както са“. Това е справочник, не медицински съвет — не ги използвайте като единствен източник за клинично решение.
  • Схемата все още може да се променя. Пробивна промяна ще се обяви предварително на този адрес.

Sitemap + IndexNow

Sitemap-индекс: /sitemap.xml — пълният индекс (лекарства, вещества, ATC, производители, заболявания, продукти). Подкрепяме IndexNow за Bing/Yandex.

Schema.org markup

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

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

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

Какво следва

  • Готово — публичният read-only API по-горе, без ключ и без регистрация.
  • В план — open-data export в GitHub (CSV) и крайна точка за промените (changes), за да може да се следи какво е обновено, без пълно изтегляне.

Съзнателно не обявяваме дати. Ако ви трябва конкретна крайна точка, пишете ни — приоритизираме по реални нужди.