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

Ключ

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

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

Запрос

Запрос

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

Без форматирования
curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Token ${API_KEY}" \
  -d '{ "query": "волы" }' \
  https://dadata.ru/api/v2/suggest/party

...

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

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

Параметры

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

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

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

Ответ

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

...

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

Примеры

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

Запрос (JSON):

Блок кода
languagejavascript
{
  "query": "волыСбербанк" 
}

...

Раскрыть
titleПоказатьОтвет
Блок кода
languagejavascript
{
    "suggestions": [
        {
            "value": "ЗАОПАО ВолыСБЕРБАНК",
            "unrestricted_value": "ЗАОПАО ВолыСБЕРБАНК",
            "data": {
                "kpp": "770901001775001001",
                "management": {
                    "name": "ЕреминГреф ДенисГерман АндреевичОскарович",
                    "post": "ГенеральныйПрезидент-председатель директорправления"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12247",
                    "full": "Публичное "addressакционерное общество",
                    "short": "ПАО"
                },
                "name": {
                    "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"",
                    "short_with_opf": "ПАО СБЕРБАНК",
                    "latin": null,
                    "full": "СБЕРБАНК РОССИИ",
                    "short": "СБЕРБАНК"
                },
                "inn": "7707083893",
                "ogrn": "1027700132195",
                "okpo": null,
                "okved": null,
                "state": {
                    "value": "109004, Москва г, Земляной Вал ул, 68/18, СТР.3status": "ACTIVE",
                    "actuality_date": 1443312000000,
                    "registration_date": 677376000000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Москва, ул Вавилова, д 19",
                    "unrestricted_value": "109004, Москва г, Земляной г Москва, ул Вавилова, д 19",
                    "data": {
						...
                    }
                }
            }
        ]

Запрос (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>
				...
                </data>
            </address>
        </data>
    </suggestions>
</SuggestResponse>

По ИНН

Запрос:

Блок кода
languagejavascript
{
  "query": "2222808138" 
}
Раскрыть
titleОтвет
Блок кода
languagehtml/xml
{
    "suggestions": [
        {
            "value": "ООО \"РОМАШКА\"",
    Вал ул, 68/18, СТР.3",
        "unrestricted_value": "ООО \"РОМАШКА\"",
            "data": null": {
                "kpp": "222201001",
                "management": {
                    "name": "Миронов Вячеслав Леонидович",
                    "post": "Директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "1226712300",
                    "full": "ЗакрытоеОбщество с акционерноеограниченной обществоответственностью",
                    "short": "ЗАОООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",
                    "short_with_opf": "ООО \"РОМАШКА\"",
                    "latin": null,
                    "full": "ВОЛЫРОМАШКА",
                    "short": "ВолыРОМАШКА"
                },
                "inn": "77094209142222808138",
                "ogrn": "10377090407531122223013120",
                "okpo": "14224803"null,
                "okved": "6352.403",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 10521648000001350950400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул Берестовая, д 54",
                    "data": {
					...
                    }
                }
            }
        }
    ]
}

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

Запрос:

Блок кода
languagehtml/xmljavascript
<req>
  <query>волы</query>
</req>

Ответ:

{
  "query": "Коварский Станислав Альбертович" 
}
Раскрыть
titleПоказатьОтвет
Блок кода
languagehtml/xml
<SuggestResponse>
{
    "suggestions": [
       
<suggestions>
 {
          
<value>ЗАО Волы</value>
  "value": "ООО \"ВЕГА\"",
           
<unrestricted_value>ЗАО
 
Волы</
"unrestricted_
value>
value": "ООО \"ВЕГА\"",
            
<data>
"data": {
           
<kpp>770901001</kpp>
     "kpp": "781401001",
             
<management>
   "management": {
                    
<name>Еремин Денис Андреевич</name>
"name": "Коварский Станислав Альбертович",
                 
<post>Генеральный директор</post>
   "post": "Генеральный директор"
                
</management>
},
            
<branch_type>MAIN</branch_type>
    "branch_type": "MAIN",
               
<branch_count>1</branch_count>
 "branch_count": 1,
                "type": "LEGAL",
                
<address>
"opf": {
                  
<value>109004, Москва г, Земляной Вал ул, 68/18, СТР.3</value>
  "code": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    
<unrestricted_value>109004, Москва г, Земляной Вал ул, 68/18, СТР.3</unrestricted_value>
"full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ВЕГА\"",
                    "short_with_opf": "ООО \"ВЕГА\"",
                
<data/>
    "latin": null,
            
</address>
        "full": "ВЕГА",
            
<type>LEGAL</type>
        "short": "ВЕГА"
               
<opf>
 },
                
<code>12267</code>
"inn": "7814255120",
                
<full>Закрытое акционерное общество</full>
"ogrn": "1157847228307",
                
<short>ЗАО</short>
"okpo": null,
                
</opf>
"okved": "52.50.1",
            
<name>
    "state": {
                   
<latin/>
 "status": "ACTIVE",
                    
<full>ВОЛЫ</full>
"actuality_date": 1440806400000,
                    
<short>Волы</short>
"registration_date": 1435795200000,
              
</name>
      "liquidation_date": null
            
<inn>7709420914</inn>
    },
            
<ogrn>1037709040753</ogrn>
    "address": {
            
<okpo>14224803</okpo>
        "value":  Санкт-Петербург, ул Новосибирская, 
<okved>63.40</okved>
д 6А, кв 2Н",
            
<state>
        "unrestricted_value":  Санкт-Петербург, ул Новосибирская, д 6А, 
<status>ACTIVE</status>
кв 2Н",
                
<registration_date>1052164800000</registration_date>
    "data": {
					...
                   
<liquidation_date/>
 }
             
</state>
   }
        
</data>
    }
    
</suggestions> </SuggestResponse>
    }