Открытый API
Исследования из каталога в формате JSON — бесплатно, без ключей и регистрации. Отдаём только то, на что у нас есть права: записи из официальных реестров (ГРЛС Минздрава России и ClinicalTrials.gov) и наши расчёты.
Список исследований
GET https://clinomir.ru/api/v1/trials/?country=RU&status=active&page=1
По 50 записей на странице, по возрастанию номера. Поле next — ссылка на следующую страницу.
| Параметр | Что делает |
|---|---|
country | Страна проведения: RU, BY, KZ, AM, KG |
status | active, planned, completed, terminated, suspended, unknown |
nct | Номер в ClinicalTrials.gov, например NCT01234567 |
permit | Номер разрешения Минздрава России |
updated_since | Только изменённые с даты ГГГГ-ММ-ДД — удобно забирать обновления раз в сутки |
page | Номер страницы |
Одно исследование
GET https://clinomir.ru/api/v1/trials/19039/
То же, что в списке, плюс полный текст критериев включения и невключения, главные показатели исследования и центры (название, город, страна — без людей и контактов).
Что в ответе и откуда
- Только опубликованные записи, которые есть в ГРЛС или ClinicalTrials.gov. Дубли из разных реестров склеены в одну запись.
- У каждой записи — только поля, которые на странице исследования в блоке «Откуда эта информация» подписаны ГРЛС, ClinicalTrials.gov или Клиномиром. В поле
sourcesуказано, откуда каждое из них. Поля из других каталогов в API не попадают. - «Кто может участвовать» (возраст, пол, критерии) и дизайн — из ClinicalTrials.gov, текст критериев на английском, как в реестре.
- Проекты, которые компании разместили на Клиномире сами, в API не входят.
- Сведений о людях в API нет.
Лимиты и как ссылаться
Не больше 60 запросов в минуту и 3000 в сутки с одного адреса; при превышении — ответ 429, повторите позже. Ответы обновляются раз в 10 минут. Нужно больше — напишите нам.
При использовании данных указывайте Клиномир и первоисточник: «Данные: ГРЛС Минздрава России (grls.rosminzdrav.ru) и ClinicalTrials.gov (Национальная медицинская библиотека США); сбор, склейка дублей и расчёты — портал «Клиномир» (clinomir.ru). Ссылайтесь на Клиномир и первоисточник.»
Данные справочные: решение об участии в исследовании принимает пациент вместе с врачом. Мы стараемся, чтобы данные были точными, но первоисточник — реестр.