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

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

	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": "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": "Сбербанк России",
        {
            "shortvalue": "СбербанкПАО России"
                }СБЕРБАНК",
                "inn"unrestricted_value": "7707083893ПАО СБЕРБАНК",
                "ogrndata": "1027700132195",{
                "okpokpp": null"775001001",
                "okvedmanagement": null,{
                    "statename": {"Греф Герман Оскарович",
                    "statuspost": "ACTIVEПрезидент-председатель правления",
                },
     "actuality_date           "branch_type": 1429056000000"MAIN",
                    "registrationbranch_datecount": 6773760000001,
                    "liquidation_datetype": null"LEGAL",
                },"opf": {
                    "addresscode": {"12247",
                    "valuefull": "гПубличное Москва, ул Вавилова, д 19акционерное общество",
                    "unrestricted_valueshort": "г Москва, ул Вавилова, д 19",
ПАО"
                },
                "dataname": {
                        "qc_complete"full_with_opf": null,
"ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "qcshort_with_houseopf": null"ПАО СБЕРБАНК",
                        "qc_geo"latin": null,
                        "postal_code"full": "117312СБЕРБАНК РОССИИ",
                        "postal_box"short": null,"СБЕРБАНК"
                },
        "country": "Россия",
       "inn": "7707083893",
                "region_with_typeogrn": "г Москва1027700132195",
                "okpo": null,
       "region_type": "г",
         "okved": null,
                 "region_type_fullstate": "город",
  {
                      "regionstatus": "МоскваACTIVE",
                        "areaactuality_with_typedate": null1443312000000,
                        "arearegistration_typedate": null677376000000,
                        "arealiquidation_type_fulldate": null,
                },
          "area": null,
      "address": {
                    "city_with_typevalue": "г Москва",
 ул Вавилова, д 19",
                    "cityunrestricted_typevalue": "г" Москва,
 ул Вавилова, д 19",
                    "city_type_fulldata": "город",
  {
						...
                      "city": "Москва",}
                }
        "settlement_with_type": null,
   }
        ]

Запрос (XML):

Блок кода

language	html/xml

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

Раскрыть

title	Ответ

Блок кода

language	html/xml

<SuggestResponse>
    <suggestions>
        "settlement_type": null,<value>ПАО СБЕРБАНК</value>
        <unrestricted_value>ПАО СБЕРБАНК</unrestricted_value>
        <data>
       "settlement_type_full": null,
    <kpp>775001001</kpp>
            <management>
        "settlement": null,
       <name>Греф Герман Оскарович</name>
               "street_with_type": "ул Вавилова",
 <post>Президент-председатель правления</post>
            </management>
             "street_type": "ул",
<branch_type>MAIN</branch_type>
            <branch_count>1</branch_count>
            <type>LEGAL</type>
  "street_type_full": "улица",
         <opf>
               "street": "Вавилова", <code>12247</code>
                <full>Публичное акционерное общество</full>
       "house_type": "д",
         <short>ПАО</short>
            </opf>
      "house_type_full": "дом",
     <name>
                <full_with_opf>ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "house":СБЕРБАНК "19",РОССИИ"</full_with_opf>
                  <short_with_opf>ПАО СБЕРБАНК</short_with_opf>
      "block_type": null,
          <latin/>
                "block": null,<full>СБЕРБАНК РОССИИ</full>
                <short>СБЕРБАНК</short>
          "flat_area": null,  </name>
            <inn>7707083893</inn>
             "flat_type": null,
<ogrn>1027700132195</ogrn>
            <okpo/>
            <okved/>
  "flat": null,
         <state>
               "fias_id": "93409d8c-d8d4-4491-838f-f9aa1678b5e6",
 <status>ACTIVE</status>
                <actuality_date>1443312000000</actuality_date>
            "kladr_id": "7700000000009240170",
   <registration_date>677376000000</registration_date>
                <liquidation_date/>
     "tax_office": "7736",
      </state>
            <address>
       "tax_office_legal": null,
        <value>г Москва, ул Вавилова, д 19</value>
           "okato": "45293554000",
    <unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>
               "oktmo": "45397000", <data>
				...
                </data>
           "geo_lat": null, </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

Блок кода

language	javascript

{
  "query": "2222808138" 
}

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
         "geo_lon"suggestions": null,[
        {
            "value":    "unparsed_parts": null,
"ООО \"РОМАШКА\"",
            "unrestricted_value": "ООО \"РОМАШКА\"",
            "qcdata": null{
                    }
  "kpp": "222201001",
              }
  "management": {
         }
        }
    ]

Запрос:

Блок кода

language	html/xml

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

Ответ:

Раскрыть

title	Показать

Блок кода

language	html/xml

"name": "Миронов Вячеслав Леонидович",

<value>ОАО

Сбербанк

России</value>

<unrestricted_value>ОАО Сбербанк России</unrestricted_value>

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

<data>

},

"branch_type": "MAIN",

<name>Греф Герман Оскарович</name>

"branch_count": 1,

<post>Президент-председатель правления</post>

"type": "LEGAL",

</management>

   "opf": {

<branch_type>MAIN</branch_type>

<branch_count>1692</branch_count>

"code": "12300",

<type>LEGAL</type>

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

<opf>

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

   "short": "ООО"

<full>Открытое

акционерное

общество</full>

},

"name": {

</opf>

        "full_with_opf": "ОБЩЕСТВО С

<name>

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

<full_with_opf>Открытое

акционерное

общество

"Сбербанк

России

</full

short_with_

opf>

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

<short_with_opf>ОАО

 "latin"

Сбербанк России"</short_with_opf>

: null,

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

<full>Сбербанк

России</full>

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

<short>Сбербанк

России</short>

},

</name>

"inn": "2222808138",

    "ogrn": "1122223013120",

<okpo/>

"okpo": null,

<state>

    "okved": "52.3",

<status>ACTIVE</status>

     "state": {

<actuality_date>1429056000000</actuality_date>

          "status": "ACTIVE",

<registration_date>677376000000</registration_date>

<liquidation

"actuality_date

/>

": 1440806400000,

</state>

"registration_date": 1350950400000,

<value>г

Москва,

ул

Вавилова, д 19</value>

 "liquidation_date": null

<unrestricted_value>г Москва, ул Вавилова, д 19</unrestricted_value>

},

<data>

"address": {

<qc_complete/>

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

<qc_house/>

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

<qc_geo/>

д 54",

<postal_code>117312</postal_code>

"data": {
					...

<postal_box/>

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

         }
        }

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

]
}

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

Запрос:

Блок кода

language	javascript

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

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
    "suggestions": [

<region_type>г</region_type>

{
            "value":

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

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

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

      "data": {

<area_with_type/>

  "kpp": "781401001",

<area_type/>

"management": {

<area_type_full/>

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

<area/>

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

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

 },
                "branch_type": "MAIN",

<city_type>г</city_type>

            "branch_count": 1,

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

         "type": "LEGAL",

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

  "opf": {

<settlement_with_type/>

   "code": "12300",

<settlement_type/>

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

<settlement_type_full/>

        "short": "ООО"

},

<street_with_type>ул Вавилова</street_with_type>

"name": {

<street_type>ул</street_type>

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

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

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

<street>Вавилова</street>

    "latin": null,

<house_type>д</house_type>

     "full": "ВЕГА",

<house_type_full>дом</house_type_full>

      "short": "ВЕГА"

},

<block_type/>

"inn": "7814255120",

"ogrn": "1157847228307",

<flat_area/>

"okpo": null,

<flat_type/>

"okved": "52.50.1",
                "state": {

<flat/>

<fias_id>93409d8c-d8d4-4491-838f-f9aa1678b5e6</fias_id>

"status": "ACTIVE",

<kladr_id>7700000000009240170</kladr_id>

"actuality_date": 1440806400000,

<tax_office>7736</tax_office>

"registration_date": 1435795200000,
                    "liquidation_date": null

<tax_office_legal/>

},

  "address": {

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

<geo_lat/>

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

<geo_lon/>

2Н",

<unparsed_parts/>

"data": {
					...

<qc/>

</data>

</address>

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

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

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

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

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

Ключ

Запрос

Запрос

Параметры

Параметры

Ответ

Примеры

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

Ответ

Примеры

По ИНН

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