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

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

	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

да

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

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

count

нет

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

	_count_server
	_count_server

status

нет

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

type

нет

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

locations

нет

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

locations_boost

нет

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

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

count

нетКоличество возвращаемых подсказок (если не указано, используется значение по умолчанию)

status

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

type

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

locations

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

Ответ

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

...

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>

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

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

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

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

Ключ

Запрос

Запрос

Заголовки

Параметры

Параметры

Ответ

Примеры

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

По ИНН

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