Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Включить страницу
SGTDOC:О «Подсказках»: подсказки по компаниям
SGTDOC:О «Подсказках»: подсказки по компаниям

Запрос

Запрос

Для пользователей бесплатных подсказок DaData.ru:

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "Сбербанк" }' \
  httpshttp:///dadata.ruВАШ_СЕРВЕР:ПОРТ/suggestions/api/v24_1/rs/suggest/party

Для пользователей платных подсказок DaData.ru:

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "Сбербанк" }' \
  http://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party

Для пользователей standalone-подсказок:

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{ "query": "Сбербанк" }' \
  http://ВАШ_СЕРВЕР:ПОРТ/suggestions/api/4_1/rs/suggest/party

...

Параметры

...

  • названию компании (либо ФИО для ИП);
  • ИНН;
  • ОГРН;
  • адресу до улицы;
  • ФИО руководителя компании. 

...

count

...

status

...

type

...

locations

...

Ограничение по региону

Включить страницу
_Заголовки (API)
_Заголовки (API)

Параметры

ПараметрОбязательный?Описание
queryдаЗапрос, для которого нужно получить подсказки.
Можно искать по:
  • названию компании (либо ФИО для ИП);
  • ИНН;
  • КПП (с версии 19.4);
  • ОГРН;
  • адресу до улицы;
  • ФИО руководителей компании (с версии 19.10) 
count
нет
Включить страницу
_count_server
_count_server
status
нетОграничение по статусу организации
type
нетОграничение по типу организации
locations
нет

Ограничение по региону

locations_boost
нетПриоритет города при ранжировании

Ответ

Возвращается список объектов организации:

Включить страницу
Объект организации
Объект организации

Примеры

Поиск по названию компании

Запрос (JSON):

Блок кода
languagejavascript
{
  "query": "Сбербанк" 
}
Раскрыть
titleОтвет
Блок кода
languagejavascript
"suggestions": [
        {

Ответ

Возвращается список объектов организации:

...

Примеры

Поиск по названию компании

Запрос (JSON):

Блок кода
languagejavascript
{
  "query": "Сбербанк" 
}
Раскрыть
titleОтвет
Блок кода
languagejavascript
"suggestions": [
        {
            "value": "ПАО СБЕРБАНК",
            "unrestricted_value": "ПАО СБЕРБАНК",
            "data": {
                "kpp": "775001001",
                "management": {
                    "name": "Греф Герман Оскарович",
                    "post": "Президент-председатель правления"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12247",
                    "full": "Публичное акционерное общество",
                    "short": "ПАО"
                },
                "name": {
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "short_with_opf": "ПАО СБЕРБАНК",
                    "latin": null,
                    "full": "СБЕРБАНК РОССИИ",
                    "short": "СБЕРБАНК"
                },
                "inn": "7707083893",
                "ogrn": "1027700132195",
                "okpo": null,
                "okved": null,
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1443312000000,
                    "registration_date": 677376000000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Москва, ул Вавилова, д 19",
                    "unrestricted_value": "г Москва, ул Вавилова, д 19",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_code": "117312",
                        "postal_box": null,
                        "country": "Россия",
                        "region_with_type": "г Москва",
                        "region_type": "г",
                        "region_type_full": "город",
                        "region": "Москва",
                        "area_with_type": null,
                        "area_type": null,
                        "area_type_full": null,
                        "area": null,
                        "city_with_type": "г Москва",
                        "city_type": "г",
                        "city_type_full": "город",
                        "city": "Москва",
                        "city_district": null,
                        "settlement_with_type": null,
                        "settlement_type": null,
                        "settlement_type_full": null,
                        "settlement": null,
                        "street_with_type": "ул Вавилова",
                        "street_type": "ул",
                        "street_type_full": "улица",
                        "street": "Вавилова",
                        "house_type": "д",
                        "house_type_full": "дом",
                        "house": "19",
                        "block_type": null,
                        "block_type_full": null,
                        "block": null,
                        "flat_area": null,
                        "square_meter_price": null,
                        "flat_price": null,
                        "flat_type": null,
                        "flat_type_full": null,
                        "flat": null,
                        "fias_id": "93409d8c-d8d4-4491-838f-f9aa1678b5e6",
                        "fias_level": null,
                        "kladr_id": "7700000000009240170",
                        "tax_office": "7736",
                        "tax_office_legal": null,
                        "capital_marker": null,
                        "okato": "45293554000",
                        "oktmo": "45397000",
                        "timezone": null,
                        "geo_lat": null,
                        "geo_lon": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                }
            }
        ]

Запрос (XML):

Блок кода
languagehtml/xml
<req>
  <query>Сбербанк</query>
</req>
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
<SuggestResponse>
    <suggestions>
        <value>ПАО СБЕРБАНК</value>
        <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
        <data>
            <kpp>775001001</kpp>
            <management>
                <name>Греф Герман Оскарович</name>
                <post>Президент-председатель правления</post>
            </management>
            <branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <type>LEGAL</type>
            <opf>
                <code>12247</code>
                <full>Публичное акционерное общество</full>
                <short>ПАО</short>
            </opf>
            <name>
                <full_with_opf>ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"</full_with_opf>
                <short_with_opf>ПАО СБЕРБАНК</short_with_opf>
                <latin/>
                <full>СБЕРБАНК РОССИИ</full>
                <short>СБЕРБАНК</short>
            </name>
            <inn>7707083893</inn>
            <ogrn>1027700132195</ogrn>
            <okpo/>
            <okved/>
            <state>
                <status>ACTIVE</status>
                <actuality_date>1443312000000</actuality_date>
                <registration_date>677376000000</registration_date>
                <liquidation_date/>
            </state>
            <address>
                <value>г Москва, ул Вавилова, д 19</value>
                <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
                <data>
                    <qc_complete/>
                    <qc_house/>
                    <qc_geo/>
                    <postal_code>117312</postal_code>
                    <postal_box/>
                    <country>Россия</country>
                    <region_with_type>г Москва</region_with_type>
                    <region_type>г</region_type>
                    <region_type_full>город</region_type_full>
                    <region>Москва</region>
                    <area_with_type/>
                    <area_type/>
                    <area_type_full/>
                    <area/>
                    <city_with_type>г Москва</city_with_type>
                    <city_type>г</city_type>
                    <city_type_full>город</city_type_full>
                    <city>Москва</city>
                    <city_district/>
                    <settlement_with_type/>
                    <settlement_type/>
                    <settlement_type_full/>
                    <settlement/>
                    <street_with_type>ул Вавилова</street_with_type>
                    <street_type>ул</street_type>
                    <street_type_full>улица</street_type_full>
                    <street>Вавилова</street>
                    <house_type>д</house_type>
                    <house_type_full>дом</house_type_full>
                    <house>19</house>
                    <block_type/>
                    <block_type_full/>
                    <block/>
                    <flat_area/>
                    <square_meter_price/>
                    <flat_price/>
                    <flat_type/>
                    <flat_type_full/>
                    <flat/>
                    <fias_id>93409d8c-d8d4-4491-838f-f9aa1678b5e6</fias_id>
                    <fias_level/>
                    <kladr_id>7700000000009240170</kladr_id>
                    <tax_office>7736</tax_office>
                    <tax_office_legal/>
                    <capital_marker/>
                    <okato>45293554000</okato>
                    <oktmo>45397000</oktmo>
                    <timezone/>
                    <geo_lat/>
                    <geo_lon/>
                    <unparsed_parts/>
                    <qc/>
                </data>
            </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

Блок кода
languagejavascript
{
  "query": "2222808138" 
}
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
{
    "suggestions": [
        {
            "value": "ООО \"РОМАШКА\"",
            "unrestricted_value": "ООО \"РОМАШКА\"",
            "data": {
                "kpp": "222201001",
                "management": {
                    "name": "Миронов Вячеслав Леонидович",
                    "post": "Директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
                    "short_with_opf": "ООО \"РОМАШКА\"",
                    "latin": null,
                    "full": "РОМАШКА",
                    "short": "РОМАШКА"
                },
                "inn": "2222808138",
                "ogrn": "1122223013120",
                "okpo": null,
                "okved": "52.3",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 1350950400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_code": "656902",
                        "postal_box": null,
                        "country": "Россия",
                        "region_with_type": "Алтайский край",
                        "region_type": "край",
                        "region_type_full": "край",
                        "region": "Алтайский",
                        "area_with_type": null,
                        "area_type": null,
                        "area_type_full": null,
                        "area": null,
                        "city_with_type": "г Барнаул",
                        "city_type": "г",
                        "city_type_full"value": "городПАО СБЕРБАНК",
                        "city"unrestricted_value": "БарнаулПАО СБЕРБАНК",
                        "city_districtdata": null,{
                        "settlement_with_type": "село Власиха",
        "kpp": "775001001",
                "settlement_typemanagement": "с",{
                        "settlement_type_full"name": "селоГреф Герман Оскарович",
                        "settlementpost": "ВласихаПрезидент-председатель правления",
                },
                "street_withbranch_type": "ул БерестоваяMAIN",
                "branch_count": 1,
        "street_type": "ул",
          "type": "LEGAL",
                "street_type_fullopf": "улица",{
                        "streetcode": "Берестовая12247",
                        "house_typefull": "дПубличное акционерное общество",
                        "house_type_full"short": "домПАО",
                },
          "house      "name": "54",{
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"block_type": null,
                        "blockshort_typewith_fullopf": "ПАО nullСБЕРБАНК",
                        "blocklatin": null,
                        "flat_area"full": "СБЕРБАНК nullРОССИИ",
                    "short": "СБЕРБАНК"
       "square_meter_price": null,
        },
                "flat_priceinn": null"7707083893",
                "ogrn": "1027700132195",
        "flat_type": null,
       "okpo": null,
                "flat_type_fullokved": null,
                        "flat"state": null,{
                        "fias_id"status": "c67c8394-ae02-4379-91c6-f755e0f1c1b2ACTIVE",
                        "fiasactuality_leveldate": null1443312000000,
                        "kladrregistration_iddate": "2200000100600690027"677376000000,
                    "liquidation_date": null
      "tax_office": "2223",
          },
                "tax_office_legaladdress": null,{
                        "capital_markervalue": null"г Москва,
 ул Вавилова, д 19",
                    "okatounrestricted_value": "01401916001"г Москва,
 ул Вавилова, д 19",
                    "oktmodata": "01701000126",{
						...
                    }
    "timezone": null,
             }
           "geo_lat": null, }
        ]

Запрос (XML):

Блок кода
languagehtml/xml
<req>
  <query>Сбербанк</query>
</req>
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
<SuggestResponse>
    <suggestions>
        <value>ПАО  "geo_lon": null,
СБЕРБАНК</value>
        <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
        <data>
         "unparsed_parts": null,
  <kpp>775001001</kpp>
            <management>
          "qc": null
     <name>Греф Герман Оскарович</name>
             }
   <post>Президент-председатель правления</post>
            }</management>
            }
<branch_type>MAIN</branch_type>
            }<branch_count>1</branch_count>
    ]
}

По ФИО руководителя

Запрос:

Блок кода
languagejavascript
{
  "query": "Коварский Станислав Альбертович" 
}
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
{        <type>LEGAL</type>
    "suggestions": [
        <opf>
  {
            "value": "ООО \"ВЕГА\"", <code>12247</code>
            "unrestricted_value": "ООО \"ВЕГА\"",
    <full>Публичное акционерное общество</full>
               "data": { <short>ПАО</short>
            </opf>
    "kpp": "781401001",
        <name>
        "management": {
       <full_with_opf>ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"</full_with_opf>
         "name": "Коварский Станислав Альбертович",
    <short_with_opf>ПАО СБЕРБАНК</short_with_opf>
               "post": "Генеральный директор"
 <latin/>
                <full>СБЕРБАНК },РОССИИ</full>
                "branch_type": "MAIN",
<short>СБЕРБАНК</short>
            </name>
      "branch_count": 1,
     <inn>7707083893</inn>
           "type": "LEGAL", <ogrn>1027700132195</ogrn>
            <okpo/>
    "opf": {
       <okved/>
            <state>
  "code": "12300",
             <status>ACTIVE</status>
       "full": "Общество с ограниченной ответственностью",
     <actuality_date>1443312000000</actuality_date>
               "short": "ООО" <registration_date>677376000000</registration_date>
                },<liquidation_date/>
            </state>
    "name": {
        <address>
            "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЕГА\"",
    <value>г Москва, ул Вавилова, д 19</value>
                "short_with_opf": "ООО \"ВЕГА\"",
    <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
                "latin": null,<data>
				...
                </data>
    "full": "ВЕГА",
        </address>
        </data>
    "short</suggestions>
</SuggestResponse>

По ИНН

Запрос:

Блок кода
languagejavascript
{
  "query": "2222808138" 
}
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
{ВЕГА"
    "suggestions": [
           },{
                "innvalue": "ООО \"7814255120РОМАШКА\"",
                "ogrnunrestricted_value": "ООО \"РОМАШКА\"1157847228307",
                "okpodata": null,{
                "okvedkpp": "52.50.1222201001",
                "statemanagement": {
                    "statusname": "ACTIVEМиронов Вячеслав Леонидович",
                    "actuality_datepost": 1440806400000,"Директор"
                    "registration_date": 1435795200000},
                    "liquidationbranch_datetype": null"MAIN",
                } "branch_count": 1,
                "addresstype": {
    "LEGAL",
                "valueopf": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",{
                    "unrestricted_valuecode": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н12300",
                    "datafull": {
"Общество с ограниченной ответственностью",
                     "qc_completeshort": null,
"ООО"
                },
            "qc_house": null,
   "name": {
                    "qcfull_with_geoopf": null,
"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
                    "postalshort_with_codeopf": "197342ООО \"РОМАШКА\"",
                        "postal_boxlatin": null,
                        "countryfull": "РоссияРОМАШКА",
                        "region_with_type"short": "г Санкт-ПетербургРОМАШКА",
                 },
                "region_typeinn": "г2222808138",
                "ogrn": "1122223013120",
       "region_type_full": "город",
         "okpo": null,
                "regionokved": "Санкт-Петербург52.3",
                        "area_with_typestate": null,{
                        "area_type"status": null"ACTIVE",
                        "areaactuality_type_fulldate": null1440806400000,
                        "arearegistration_date": null1350950400000,
                    "liquidation_date": null
     "city_with_type": "г Санкт-Петербург",
           },
                "city_typeaddress": "г",{
                    "value": "Алтайский край, г  "city_type_full": "городБарнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д "city": "Санкт-Петербург"54",
                        "city_districtdata": null,{
					...
                    }
    "settlement_with_type": null,
           }
             "settlement_type": null,}
        }
    ]
}

По ФИО руководителя

Запрос:

Блок кода
languagejavascript
{
  "query": "Коварский Станислав Альбертович" 
}
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
{
      "settlement_type_full"suggestions": null,[
        {
            "value":    "settlement": null,
  "ООО \"ВЕГА\"",
                      "street_with_type"unrestricted_value": "ул НовосибирскаяООО \"ВЕГА\"",
            "data": {
                "street_typekpp": "ул781401001",
                        "street_type_full"management": "улица",
    {
                    "streetname": "НовосибирскаяКоварский Станислав Альбертович",
                        "house_typepost": "дГенеральный директор",
                },
          "house      "branch_type_full": "домMAIN",
                "branch_count": 1,
       "house": "6А",
         "type": "LEGAL",
                "block_typeopf": null,{
                        "block_type_full"code": null"12300",
                    "full": "Общество с ограниченной ответственностью"block": null,
                    "short": "ООО"
     "flat_area": null,
          },
              "square_meter_price  "name": null,{
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "flat_price": null,
   \"ВЕГА\"",
                     "flatshort_with_typeopf": "квООО \"ВЕГА\"",
                        "flat_type_fulllatin": null,
                        "flatfull": "ВЕГА",
                        "fias_idshort": "d70613ff-9a27-4e44-9a86-4162e938820d",ВЕГА"
                },
         "fias_level": null,
          "inn": "7814255120",
                "kladr_idogrn": "78000000000093700061157847228307",
                "okpo": null,
        "tax_office": "7814",
       "okved": "52.50.1",
                "tax_office_legalstate": null,
    {
                    "capital_markerstatus": null"ACTIVE",
                        "okato"actuality_date": "40270563000"1440806400000,
                        "oktmo"registration_date": "40323000"1435795200000,
                        "timezoneliquidation_date": null,
                },
            "geo_lat    "address": null,{
                    "value":  Санкт-Петербург,  "geo_lon": null,
    ул Новосибирская, д 6А, кв 2Н",
                    "unparsedunrestricted_partsvalue": null,
    "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",
                    "qcdata": null{
					...
                    }
                }
            }
        }