Старая версия документации

Поиск (search)

Получение списка компаний по строке запроса.

METHOD_NAME = search

URL метода search имеет вид:
(описание выделенных параметров смотрите в разделе Описание версии) 

https://zachestnyibiznesapi.ru/paid/data/search?PARAMETERS&api_key=YOUR_API_KEY&_format=FORMAT_NAME

Тестовый запрос:

https://zachestnyibiznesapi.ru/paid/data/test-search?string=ооо+высота

PARAMETERS:
(параметры метода)

название описание требование
api_key api ключ приложения обязательно
string строка запроса обязательно
filters фильтры зароса необязательно
page страница списка (по 50 на странице) опционально
_format формат ответа - XML или JSON (по умолчанию) опционально

Возможности filters в поиске:
(параметры фильтров)

параметры фильтров пояснение
&filters[status]=1 поиск активных организаций
&filters[ul]=1 поиск юридических лиц
&filters[ip]=1 поиск индивидуальных предпринимателей

Дополнительные возможности поиска:

префикс описание поиска, пример
mass_ массовость адреса (адрес из строки Адрес)
например: mass_117997, г Москва, улица Вавилова, 19
est_ учреждённые компании (ОГРН + ИНН учредителя)
например: est_1027700132195 7707083893
managed_ управляемые организации (ОГРН + ИНН головной организации)
например: managed_1027700132195 7707083893
aff_ аффилированность (руководитель + учредитель)
например: aff_232200289300, либо aff_ИВАНОВ ИВАН ИВАНОВИЧ (ФИО должно совпадать со свойством fl_aff, при получении даных из метода card)
affb_ и afff_ аффилированность по руководителям и учредителям соответственно
например: affb_232200289300, либо afff_ИВАНОВ ИВАН ИВАНОВИЧ (ФИО должно совпадать со свойством fl_aff, при получении даных из метода card)
ip_ поиск ИП
например: ip_232200289300
date_ поиск Дате регистрации
например: date_2018-11-12
okvedreg_ поиск по Региону И ОКВЭД
например: okvedreg_77 64.19

Пример:

Запрос:

https://zachestnyibiznesapi.ru/paid/data/search?string=ооо+высота&api_key=YOUR_API_KEY

Ответ:

JSON
{
  "status": "200",
  "message": "Запрос выполнен успешно",
  "body": {
    "total": 1415,
    "docs": [
      {
        "id": "1127847347737",
        "ТипДокумента": "ul",
        "НаимЮЛСокр": "ООО \"ВЫСОТА\"",
        "НаимЮЛПолн": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЫСОТА\"",
        "Активность": "Действующее",
        "ИНН": "7810874578",
        "КПП": "781001001",
        "ОбрДата": "29.06.2012",
        "Адрес": "196158, г Санкт-Петербург, проспект Космонавтов, 65 КОРПУС 2 ЛИТ. А, ПОМЕЩЕНИЕ 33Н",
        "КодОКВЭД": "56.10",
        "НаимОКВЭД": "Деятельность ресторанов и услуги по доставке продуктов питания",
        "Руководитель": [
          "Батуева Лариса Леонидовна"
        ]
      },
      ...
      ...
      ...
      {
        "id": "1164027065950",
        "ТипДокумента": "ul",
        "НаимЮЛСокр": "ООО \"ВЫСОТА\"",
        "НаимЮЛПолн": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЫСОТА\"",
        "Активность": "Действующее",
        "ИНН": "4010002702",
        "КПП": "401001001",
        "ОбрДата": "21.11.2016",
        "Адрес": "249500, Калужская обл, поселок Бетлица, район Куйбышевский, улица Кирова, СТРОЕНИЕ 40/6, ПОМЕЩЕНИЕ 1",
        "КодОКВЭД": "47.25.1",
        "НаимОКВЭД": "Торговля розничная алкогольными напитками, включая пиво, в специализированных магазинах",
        "Руководитель": [
          "Навалихин Анатолий Владимирович"
        ]
      }
    ]
  }
}
XML:

Модель данных метода Search:

наименование поля описание
id ID документа (ОГРН, ИНН, ОГРНИП или ИННФЛ)
ТипДокумента Юридическое лицо (ul)/Физическое лицо (ip)/Иностранное подразделение (rafp). Метод получения карточки ip/ul - card. Метод получения карточки rafp - rafp
НаимЮЛСокр Сокращенное наименование юридического лица
НаимЮЛПолн Полное наименование юридического лица
Активность Активность юридического/физического лица
ИНН Идентификационный номер налогоплательщика
КПП Код причины постановки на учет
ОбрДата Дата образовании юрдического лица
Адрес Адрес (место нахождения) юридического лица
КодОКВЭД Код по Общероссийскому классификатору видов экономической деятельности
НаимОКВЭД Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности
Руководитель Сведения о руководителе юридического лица