Документация открытого API

API работает

Быстрый старт

Отправьте обычный GET-запрос. Ключ для чтения публичных данных не нужен.

GEThttps://openrating.operator.kg/api/v1/companies?city=Бишкек

fetch("https://openrating.operator.kg/api/v1/companies?category=medicine")
  .then(response => response.json())
  .then(({ data }) => console.log(data));

Компании

Поиск и фильтрация профилей. Ответ содержит рейтинг, OA Index, источники и нормализованные отзывы.

qПоиск по названию, категории и услугам

categorySlug категории, например medicine

cityГород на русском языке

limitОт 1 до 100, по умолчанию 20

offsetСмещение для пагинации

Эндпоинты

GET/api/v1/companiesСписок и поиск GET/api/v1/companies/:slugОдна компания GET/api/v1/categories26 категорий GET/api/v1/locationsВся география КР GET/api/v1/rankings/medicineРейтинг медицины из разрешённых данных GET/api/v1/sourcesИсточники

Партнёрская загрузка отзывов

POST /api/v1/ingestion/reviews принимает до 100 отзывов за запрос. Доступ выдаётся после проверки источника: отдельный Bearer-токен, список разрешённых доменов и режим обязательной модерации. Для повторной отправки используйте тот же external_id — дубликат не будет создан.

Лицензия и использование

Собственные данные OA KG доступны по ODC-BY 1.0. Официальные и партнёрские записи сохраняют лицензию и атрибуцию первичного источника; они указаны в поле data_source.

Отзывы

Публичная выгрузка одобренных отзывов без ключа. Доступны фильтры company_slug, source, category, q, limit и offset. Ответ содержит атрибуцию и URL первичного источника, но не раскрывает IP или контакты авторов.