История страницы

Включить страницу

	SGTDOC:О «Подсказках»: подсказки по компаниям
	SGTDOC:О «Подсказках»: подсказки по компаниям

Запрос

...

Без форматирования

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):

Блок кода

language	javascript

{
  "query": "Сбербанк" 
}

Раскрыть

title	Ответ

Блок кода

language	javascript

"suggestions": [
        {

Ответ

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

...

Примеры

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

Запрос (JSON):

Блок кода

language	javascript

{
  "query": "Сбербанк" 
}

Раскрыть

title	Ответ

Блок кода

language	javascript

"suggestions": [
        {
            "value": "ОАО Сбербанк России",
            "unrestricted_value": "ОАО Сбербанк России",
            "data": {
                "kpp": "775001001",
                "management": {
                    "name": "Греф Герман Оскарович",
                    "post": "Президент-председатель правления"
                },
                "branch_type": "MAIN",
                "branch_count": 1692,
                "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": 1429056000000,
                    "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": "Москва",
                        "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": null,
                        "flat_area": null,
                        "flat_type": null,
                        "flat": null,
                        "fias_id": "93409d8c-d8d4-4491-838f-f9aa1678b5e6",
                        "kladr_id": "7700000000009240170",
                        "tax_office": "7736",
                        "tax_office_legal": null,
                        "okato": "45293554000",
                        "oktmo": "45397000",
                        "geo_lat": null,
                        "geo_lon": null,
                        "unparsed_parts": null,
                        "qc": null
                    }
                }
            }
        }
    ]

Запрос (XML):

Блок кода

language	html/xml

<req>
  <query>Сбербанк</query>
</req>

Раскрыть

title	Ответ

Блок кода

language	html/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>1692</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>1429056000000</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>
                    <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/>
                    <flat_area/>
                    <flat_type/>
                    <flat/>
                    <fias_id>93409d8c-d8d4-4491-838f-f9aa1678b5e6</fias_id>
                    <kladr_id>7700000000009240170</kladr_id>
                    <tax_office>7736</tax_office>
                    <tax_office_legal/>
                    <okato>45293554000</okato>
                    <oktmo>45397000</oktmo>
                    <geo_lat/>
                    <geo_lon/>
                    <unparsed_parts/>
                    <qc/>
                </data>
            </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

Блок кода

language	javascript

{
  "query": "2222808138" 
}

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
    "suggestions": [
        {
            "value": "ООО Ромашка",
            "unrestricted_value": "ООО Ромашка",
            "data": {
                "kpp": "222201001",
                "management": {
                    "name": "Миронов Вячеслав Леонидович",
                    "post": "Директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12165",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "Общество с ограниченной ответственностью \"Ромашка\"",
                    "short_with_opf": "ООО \"Ромашка\"",
                    "latin": null,
                    "full": "Ромашка",
                    "short": "Ромашка"
                },
                "inn": "2222808138",
                "ogrn": "1122223013120",
                "okpo": "10025969",
                "okved": "52.3",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1422057600000,
                    "registration_date": 1350950400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "data": {
                        "qc_complete": null,
                        "qc_house": null,
                        "qc_geo": null,
                        "postal_codevalue": "656902ПАО СБЕРБАНК",
                        "postal_box"unrestricted_value": null"ПАО СБЕРБАНК",
                        "country"data": "Россия",{
                        "region_with_type"kpp": "Алтайский край775001001",
       
                 "region_typemanagement": "край",
    {
                    "region_type_fullname": "крайГреф Герман Оскарович",
                        "regionpost": "АлтайскийПрезидент-председатель правления",
                },
        "area_with        "branch_type": null"MAIN",
                "branch_count": 1,
         "area_type": null,
          "type": "LEGAL",
                "area_type_fullopf": null,{
                        "areacode": null"12247",
                        "city_with_typefull": "гПубличное акционерное Барнаулобщество",
                        "city_type"short": "гПАО",

                },
                "city_type_fullname": "город",{
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "city\":СБЕРБАНК РОССИИ\"Барнаул",
                        "settlementshort_with_typeopf": "селоПАО ВласихаСБЕРБАНК",
                        "settlement_type"latin": "с"null,
                        "settlement_type_full": "селоСБЕРБАНК РОССИИ",
                        "settlementshort": "ВласихаСБЕРБАНК",
                        "street_with_type": "ул Берестовая"},
                        "street_type"inn": "ул7707083893",
                        "street_type_full"ogrn": "улица1027700132195",
                "okpo": null,
        "street": "Берестовая",
       "okved": null,
                "house_typestate": "д",{
                        "house_type_full"status": "домACTIVE",
                        "house"actuality_date": "54"1443312000000,
                        "blockregistration_typedate": null,
   677376000000,
                     "blockliquidation_date": null,
                },
                "flat_areaaddress": null,{
                        "flat_type"value": "г nullМосква,
 ул Вавилова, д 19",
                    "flatunrestricted_value": null,
 "г Москва, ул Вавилова, д 19",
                    "data": {
						...
       "fias_id": "c67c8394-ae02-4379-91c6-f755e0f1c1b2",
            }
            "kladr_id": "2200000100600690027",
   }
            }
         "tax_office": "2223",]

Запрос (XML):

Блок кода

language	html/xml

<req>
  <query>Сбербанк</query>
</req>

Раскрыть

title	Ответ

Блок кода

language	html/xml

<SuggestResponse>
    <suggestions>
        <value>ПАО СБЕРБАНК</value>
        <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
  "tax_office_legal": null,
     <data>
            <kpp>775001001</kpp>
       "okato": "01401916001",
    <management>
                <name>Греф Герман Оскарович</name>
  "oktmo": "01701000126",
             <post>Президент-председатель правления</post>
          "geo_lat": null,  </management>
            <branch_type>MAIN</branch_type>
            "geo_lon": null,<branch_count>1</branch_count>
            <type>LEGAL</type>
            "unparsed_parts": null,
<opf>
                <code>12247</code>
         "qc": null
      <full>Публичное акционерное общество</full>
            }
    <short>ПАО</short>
            }</opf>
            }<name>
          }
    ]
}

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

Запрос:

Блок кода

language	javascript

{
  "query": "Коварский Станислав Альбертович" 
}

Раскрыть

title	Ответ

Блок кода

language	html/xml

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

По ИНН

Запрос:

Блок кода

language	javascript

{
  "query": "2222808138" 
}

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
         "namesuggestions": {[
        {
            "full_with_opfvalue": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ ООО \"ОГРАДАРОМАШКА\"",
                    "shortunrestricted_with_opfvalue": "ООО \"ОГРАДАРОМАШКА\"",
            "data": {
                "latinkpp": null"222201001",
                    "fullmanagement": "ОГРАДА",{
                    "shortname": "ОГРАДАМиронов Вячеслав Леонидович",
                   }, "post": "Директор"
                "inn": "7811585868"},
                "ogrnbranch_type": "1147847263607MAIN",
                "okpobranch_count": null1,
                "okvedtype": "28.52LEGAL",
                "stateopf": {
                    "statuscode": "ACTIVE12300",
                    "actuality_datefull": 1418256000000,
"Общество с                   "registration_date": 1406505600000ограниченной ответственностью",
                    "liquidation_dateshort": null"ООО"
                },
                "addressname": {
                    "valuefull_with_opf": "г Санкт-Петербург, пр-кт Обуховской Обороны, д 69В, кв 3НОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
                    "unrestrictedshort_with_valueopf": "г Санкт-Петербург, пр-кт Обуховской Обороны, д 69В, кв 3Н"ООО \"РОМАШКА\"",
                    "latin": null,
                    "datafull": {
"РОМАШКА",
                    "short": "РОМАШКА"
       "qc_complete": null,
        },
                "qc_houseinn": null"2222808138",
                "ogrn": "1122223013120",
                "qc_geookpo": null,
                "okved": "52.3",
       "postal_code": "192029",
         "state": {
                    "postal_boxstatus": null"ACTIVE",
                        "countryactuality_date": "Россия"1440806400000,
                        "regionregistration_with_typedate": "г Санкт-Петербург"1350950400000,
                        "regionliquidation_typedate": "г",null
                },
        "region_type_full        "address": "город",
    {
                    "regionvalue": "Санкт-Петербург",
    Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "areaunrestricted_with_typevalue": null,
     "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "area_typedata": null,{
					...
                        "area_type_full": null, }
                }
        "area": null,
   }
        }
    ]
}

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

Запрос:

Блок кода

language	javascript

{
  "query": "Коварский Станислав Альбертович" 
}

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
    "city_with_typesuggestions": "г Санкт-Петербург",[
        {
            "value": "ООО \"ВЕГА\"",
            "cityunrestricted_typevalue": "ООО \"гВЕГА\"",
            "data": {
                "city_type_fullkpp": "город781401001",
                        "citymanagement": "Санкт-Петербург",{
                    "name": "Коварский Станислав  "settlement_with_type": nullАльбертович",
                        "settlement_typepost": null,"Генеральный директор"
                },
        "settlement_type_full": null,
       "branch_type": "MAIN",
                "settlementbranch_count": null1,
                        "street_with_type": "пр-кт Обуховской ОбороныLEGAL",
                        "street_type": "пр-кт",
   "opf": {
                    "street_type_fullcode": "проспект12300",
                        "streetfull": "Обуховской ОбороныОбщество с ограниченной ответственностью",
                        "house_type"short": "дООО",
                },
        "house_type_full        "name": "дом",{
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ "house": "69ВОТВЕТСТВЕННОСТЬЮ \"ВЕГА\"",
                        "blockshort_with_typeopf": null"ООО \"ВЕГА\"",
                        "blocklatin": null,
                        "flat_areafull": null"ВЕГА",
                        "flat_typeshort": "квВЕГА",
                },
                "flatinn": "3Н7814255120",
                "ogrn": "1157847228307",
       "fias_id": "ff4ba43a-61a3-489d-af9d-92b4db1cac77",
        "okpo": null,
                "kladr_idokved": "780000000000954018252.50.1",
                "state": {
                    "tax_officestatus": "7811ACTIVE",
                        "taxactuality_office_legaldate": null1440806400000,
                        "okatoregistration_date": "40285561000"1435795200000,
                    "liquidation_date": null
   "oktmo": "40378000",
             },
                "geo_lataddress": null,{
                    "value": "г Санкт-Петербург,  "geo_lon": null,
    ул Новосибирская, д 6А, кв 2Н",
                    "unparsedunrestricted_partsvalue": null,
     "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",
                    "qcdata": null{
					...
                    }
                }
            }
        }
    ]
}

Дерево страниц

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

Старая версия 15

Новая версия Текущий

Ключ

Запрос

Запрос

Параметры

Параметры

Ответ

Примеры

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

Ответ

Примеры

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

По ИНН

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

По ИНН

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