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

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

	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/4_1/v2rs/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

Заголовки

Заголовок

Описание

Content-Type

Тип данных в запроосе: application/json или application/xml

Accept

Тип данных в ответе: application/json или application/xml

Authorization

API-ключ в формате: Token ${API_KEY}

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

Параметры

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

	_Заголовки (API)
	_Заголовки (API)

Параметры

ПараметрОбязательный?ОписаниеqueryдаЗапрос, для которого нужно получить подсказки

count

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

status

нет

Параметр Обязательный? Описание

query

да

Запрос, для которого нужно получить подсказки.
Можно искать по:

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

count

нет

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

	_count_server
	_count_server

status

нет

Ограничение по статусу организации
type	нет	Ограничение по типу организации
locations	нет	Ограничение по региону

Ответ

locations_boost

нет

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

Ответ

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

...

title	Показать

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

	Объект организации
	Объект организации

Примеры

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

Запрос :

Блок кода

language	javascript

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

Ответ:

(JSON):

Блок кода

language	javascript

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

Раскрыть

title	Ответ

Блок кода

language	javascript

"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": {
						...
                    }
                }
            }
        ]

Запрос (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>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>

По ИНН

Запрос:

Блок кода

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": "12300",
                    "full": "Общество с ограниченной ответственностью",
                    "short": "ООО"
                },
                "name": {
                    "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"РОМАШКА\"",

Раскрыть

title	Показать

Блок кода

language	javascript

{
    "suggestions": [
        {
            "valueshort_with_opf": "ЗАО ВолыООО \"РОМАШКА\"",
             "unrestricted_value": "ЗАО Волы",
       "latin": null,
                    "datafull": {"РОМАШКА",
                    "kppshort": "770901001РОМАШКА",
                "management": {
    },
                "nameinn": "Еремин Денис Андреевич2222808138",
                    "postogrn": "Генеральный директор1122223013120",
                  }"okpo": null,
                "branch_typeokved": "MAIN52.3",
                "branch_countstate": 1,
{
                    "addressstatus": {"ACTIVE",
                    "valueactuality_date": "1090041440806400000, Москва г, Земляной Вал ул, 68/18, СТР.3",

                    "registration_date": 1350950400000,
            "unrestricted_value": "109004, Москва г, Земляной Вал ул, 68/18, СТР.3", "liquidation_date": null
                },
     "data": null
            "address": {
    },
                "typevalue": "LEGAL"Алтайский край,
 г Барнаул, село Власиха, ул Берестовая, д 54",
        "opf": {
           "unrestricted_value": "Алтайский край, г Барнаул, село Власиха, ул  "code": "12267Берестовая, д 54",
                    "fulldata": "Закрытое акционерное общество",{
					...
                    "short": "ЗАО"}
                },
            }
     "name": {
  }
    ]
}

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

Запрос:

Блок кода

language	javascript

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

Раскрыть

title	Ответ

Блок кода

language	html/xml

{
         "latinsuggestions": null,[
        {
            "fullvalue": "ВОЛЫООО \"ВЕГА\"",
            "unrestricted_value": "ООО \"ВЕГА\"",
            "shortdata": "Волы"{
                }"kpp": "781401001",
                "innmanagement": "7709420914",
{
                    "ogrnname": "1037709040753Коварский Станислав Альбертович",
                    "okpopost": "14224803Генеральный директор",
                "okved": "63.40"},
                "statebranch_type": {
  "MAIN",
                  "statusbranch_count": "ACTIVE"1,
                    "registration_date"type": 1052164800000"LEGAL",
                    "liquidation_dateopf": null{
                }
     "code": "12300",
      }
        }
    ]
}

Запрос:

Блок кода

language	html/xml

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

Ответ:

Раскрыть

title	Показать

Блок кода

language	html/xml

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

<unrestricted_value>ЗАО Волы</unrestricted_value>

"short": "ООО"

<data>

},

"name": {

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

<name>Еремин

Денис

Андреевич</name>

<post>Генеральный директор</post>

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

</management>

      "latin": null,

<branch_type>MAIN</branch_type>

<branch_count>1</branch_count>

  "full": "ВЕГА",

           "short": "ВЕГА"

<value>109004,

Москва

г,

Земляной

Вал

ул,

68/18,

СТР.3</value>

},

<unrestricted_value>109004,

Москва

г,

Земляной

Вал ул, 68/18, СТР.3</unrestricted_value>

 "inn": "7814255120",

<data/>

"ogrn": "1157847228307",

</address>

"okpo": null,

<type>LEGAL</type>

    "okved": "52.50.1",

<opf>

        "state": {

             "status": "ACTIVE",

<full>Закрытое

акционерное

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

"actuality_date": 1440806400000,

</opf>

<name>

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

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

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

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

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

Ключ

Запрос

Запрос

Заголовки

Параметры

Параметры

Ответ

Ответ

Примеры

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

По ИНН

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