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

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

	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": [

Ответ

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

...

title	Показать

...

Примеры

Запрос:

Блок кода

language	javascript

{
  "query": "волы" 
}

Ответ:

Раскрыть

title	Показать

Блок кода

language	javascript

"suggestions": [
        {
            "value": "ЗАО Волы",
            "unrestricted_value": "ЗАО Волы",
            "data": {
                "kpp": "770901001",
                "management": {
                    "name": "ЕРЕМИН ДЕНИС АНДРЕЕВИЧ",
                    "post": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "address": {
                    "value": "г Москва, ул Земляной Вал, д 68/18 стр 3",
                    "unrestricted_value": "г Москва, ул Земляной Вал, д 68/18 стр 3",
                    "data": {
                        "qc_complete": null,
            {
            "qc_housevalue": null"ПАО СБЕРБАНК",
                        "qc_geo"unrestricted_value": null"ПАО СБЕРБАНК",
                        "postal_code": "109004",
       "data": {
                 "postal_boxkpp": null"775001001",
                        "country"management": "Россия",{
                        "region_with_type"name": "гГреф Герман МоскваОскарович",
                        "region_typepost": "гПрезидент-председатель правления",
                 },
                "regionbranch_type_full": "городMAIN",
                "branch_count": 1,
        "region": "Москва",
       "type": "LEGAL",
                "area_with_typeopf": null,{
                        "area_type"code": null"12247",
                        "area_type_full": null "Публичное акционерное общество",
                        "areashort": null,"ПАО"
                },
         "city_with_type": "г Москва",
       "name": {
                    "cityfull_with_typeopf": "г",
ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "cityshort_typewith_fullopf": "ПАО СБЕРБАНК"город",
                        "citylatin": "Москва"null,
                        "settlement_with_type"full": null"СБЕРБАНК РОССИИ",
                        "settlement_typeshort": null,"СБЕРБАНК"
                },
        "settlement_type_full": null,
       "inn": "7707083893",
                "settlementogrn": null"1027700132195",
                "okpo": null,
       "street_with_type": "ул Земляной Вал",
        "okved": null,
                "street_typestate": "ул",
    {
                    "street_type_fullstatus": "улицаACTIVE",
                        "street"actuality_date": "Земляной Вал"1443312000000,
                        "houseregistration_typedate": "д"677376000000,
                        "houseliquidation_type_fulldate": "дом",null
                },
        "house        "address": "68/18",
  {
                      "block_typevalue": "стр"г Москва,
 ул Вавилова, д 19",
                     "block""unrestricted_value": "3"г Москва,
 ул Вавилова, д 19",
                    "flat_areadata": null,
{
						...
                    }
     "flat_type": null,
           }
            }
     "flat": null,
     ]

Запрос (XML):

Блок кода

language	html/xml

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

Раскрыть

title	Ответ

Блок кода

language	html/xml

<SuggestResponse>
    <suggestions>
        <value>ПАО СБЕРБАНК</value>
         "fias_id": "a9df9ae2-c5ac-4a87-8735-ca99ba2b11f1",
    <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
        <data>
            "kladr_id": "7700000000013400140",<kpp>775001001</kpp>
            <management>
            "tax_office": "7709",
   <name>Греф Герман Оскарович</name>
                   "tax_office_legal": null,<post>Президент-председатель правления</post>
            </management>
            "okato": "45286580000",<branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <type>LEGAL</type>
  "oktmo": "45381000",
         <opf>
               "geo_lat": null, <code>12247</code>
                <full>Публичное акционерное общество</full>
      "geo_lon": null,
         <short>ПАО</short>
            </opf>
   "unparsed_parts": null,
        <name>
                "qc": null
   <full_with_opf>ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"</full_with_opf>
                 }<short_with_opf>ПАО СБЕРБАНК</short_with_opf>
                },<latin/>
                "type": "LEGAL",
<full>СБЕРБАНК РОССИИ</full>
                <short>СБЕРБАНК</short>
       "opf": {
    </name>
            <inn>7707083893</inn>
    "code": "12267",
       <ogrn>1027700132195</ogrn>
             "full": "Закрытое акционерное общество",
<okpo/>
            <okved/>
           "short": "ЗАО" <state>
                },<status>ACTIVE</status>
                "name": {
    <actuality_date>1443312000000</actuality_date>
                "full_with_opf": "Закрытое акционерное общество \"Волы\"",
<registration_date>677376000000</registration_date>
                <liquidation_date/>
          "short_with_opf": "ЗАО \"Волы\"", </state>
             <address>
       "latin": null,
        <value>г Москва, ул Вавилова, д 19</value>
        "full": "Волы",
       <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
        "short": "Волы"
       <data>
				...
         },
       </data>
         "inn": "7709420914",
  </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

Блок кода

language	javascript

{
  "

ogrn

query": "2222808138" 
}

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
    "suggestions": [
   "1037709040753",
     {
            "okpovalue": "ООО \"14224803РОМАШКА\"",
                "okved"unrestricted_value": "63.40ООО \"РОМАШКА\"",
                "statedata": {
                    "statuskpp": "ACTIVE222201001",
                    "registration_date"management": 1052164800000,
             {
       "liquidation_date": null
            "name": "Миронов Вячеслав  }Леонидович",
            }
        }
]

Запрос:

Блок кода

language	html/xml

<req>
  <query>волы</query>
</req>

Ответ:

Раскрыть

title	Показать

Блок кода

language	html/xml

"post": "Директор"

<value>ЗАО

Волы</value>

},

<unrestricted_value>ЗАО

Волы</unrestricted_value>

<data>

"branch_type": "MAIN",

"branch_count": 1,

    "type": "LEGAL",

<name>ЕРЕМИН

ДЕНИС

АНДРЕЕВИЧ</name>

  "opf": {

<post>ГЕНЕРАЛЬНЫЙ

ДИРЕКТОР</post>

      "code": "12300",

</management>

<branch_type>MAIN</branch_type>

   "full": "Общество с ограниченной ответственностью",

<branch_count>1</branch_count>

   "short": "ООО"

<value>г

Москва,

ул

Земляной

Вал, д 68/18 стр 3</value>

},
                "name": {

<unrestricted_value>г

Москва,

ул

Земляной

Вал,

д

68/18

стр

3</unrestricted_value>

           "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ

<data>

ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",

<qc_complete/>

"short_with_opf": "ООО \"РОМАШКА\"",

<qc_house/>

"latin": null,

<qc_geo/>

"full": "РОМАШКА",

<postal_code>109004</postal_code>

"short": "РОМАШКА"
                },

<postal_box/>

            "inn": "2222808138",

<country>Россия</country>

         "ogrn": "1122223013120",

<region_with_type>г

Москва</region_with_type>

     "okpo": null,

<region_type>г</region_type>

  "okved": "52.3",

<region_type_full>город</region_type_full>

"state": {

<region>Москва</region>

"status": "ACTIVE",

<area_with_type/>

"actuality_date": 1440806400000,

<area_type/>

"registration_date": 1350950400000,

<area_type_full/>

"liquidation_date": null

<area/>

},

<city_with_type>г Москва</city_with_type>

"address": {

<city_type>г</city_type>

"value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",

<city_type_full>город</city_type_full>

         "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д

<city>Москва</city>

54",

<settlement_with_type/>

"data": {
					...

<settlement_type/>

<settlement_type_full/>

}
            }

<street_with_type>ул Земляной Вал</street_with_type>

]
}

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

Запрос:

Блок кода

language	javascript

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

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
    "suggestions": [
        {

<street_type>ул</street_type>

       "value": "ООО \"ВЕГА\"",

<street_type_full>улица</street_type_full>

"unrestricted_value": "ООО \"ВЕГА\"",
            "data": {

<street>Земляной

Вал</street>

       "kpp": "781401001",

<house_type>д</house_type>

    "management": {

<house_type_full>дом</house_type_full>

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

        "post": "Генеральный директор"

<block_type>стр</block_type>

},

  "branch_type": "MAIN",

<flat_area/>

"branch_count": 1,
                "type": "LEGAL",

<flat_type/>

             "opf": {

<flat/>

              "code": "12300",

<fias_id>a9df9ae2-c5ac-4a87-8735-ca99ba2b11f1</fias_id>

               "full": "Общество с ограниченной

<kladr_id>7700000000013400140</kladr_id>

ответственностью",

<tax_office>7709</tax_office>

"short": "ООО"

},

<tax_office_legal/>

              "name": {

               "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ

ОТВЕТСТВЕННОСТЬЮ \"ВЕГА\"",

<geo_lat/>

"short_with_opf": "ООО \"ВЕГА\"",

<geo_lon/>

"latin": null,

<unparsed_parts/>

"full": "ВЕГА",

<qc/>

"short": "ВЕГА"

</data>

},

</address>

      "inn": "7814255120",

<type>LEGAL</type>

<opf>

"ogrn": "1157847228307",

"okpo": null,

<full>Закрытое акционерное общество</full>

"okved": "52.50.1",

"state": {

</opf>

<name>

"status": "ACTIVE",

<full_with_opf>Закрытое

акционерное

общество

Волы"</full_with_opf>

actuality_date": 1440806400000,

<short_with_opf>ЗАО

Волы"</short_with_opf>

registration_date": 1435795200000,

    "liquidation_date": null

},

 "address": {

</name>

        "value": "г Санкт-Петербург,

ул Новосибирская, д 6А, кв 2Н",

"unrestricted_value": "г Санкт-Петербург, ул Новосибирская, д 6А, кв 2Н",

<state>

"data": {
					...

<status>ACTIVE</status>

<registration_date>1052164800000</registration_date>

<liquidation_date/>

</state>

</data> </suggestions> </SuggestResponse>

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

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

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

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

Ключ

Запрос

Запрос

Параметры

Параметры

Ответ

Примеры

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

Ответ

Примеры

По ИНН

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