Чтобы указать приоритетный город или регион для организации, используйте параметр locations_boost.

Ранжируем компании по адресу, ИП по региону ИНН.

Передавайте код КЛАДР города (kladr_id).  Можно указать несколько городов.


Санкт-Петербург

{
    "query": "газпром",
    "locations_boost": [{
        "kladr_id": "78"
    }]
}

Ответ:

{
    "suggestions": [
        {
            "value": "ОАО \"ГАЗПРОМ ГАЗОРАСПРЕДЕЛЕНИЕ\"",
            "unrestricted_value": "ОАО \"ГАЗПРОМ ГАЗОРАСПРЕДЕЛЕНИЕ\"",
            "data": {
                "kpp": "783801001",
                "management": null,
                "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": "7838306818",
                "ogrn": "1047855099170",
                "okpo": null,
                "okved": "40.20.2",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 1096588800000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Санкт-Петербург, Конногвардейский б-р, д 17А",
                    "unrestricted_value": "г Санкт-Петербург, Конногвардейский б-р, д 17А",
                    "data": {
                        ...
                    }
                }
            }
        },
        {
            "value": "ПАО \"ГАЗПРОМ НЕФТЬ\"",
            "unrestricted_value": "ПАО \"ГАЗПРОМ НЕФТЬ\"",
            "data": {
                "kpp": "783801001",
                "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": "5504036333",
                "ogrn": "1025501701686",
                "okpo": null,
                "okved": "51.51",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1444780800000,
                    "registration_date": 812937600000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Санкт-Петербург, ул Галерная, д 5А",
                    "unrestricted_value": "г Санкт-Петербург, ул Галерная, д 5А",
                    "data": {
                        ...
                    }
                }
            }
        },
        {
            "value": "ЗАО \"ГАЗПРОМНЕФТЬ-АЭРО\"",
            "unrestricted_value": "ЗАО \"ГАЗПРОМНЕФТЬ-АЭРО\"",
            "data": {
                "kpp": "783801001",
                "management": {
                    "name": "Егоров Владимир Егорович",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12267",
                    "full": "Закрытое акционерное общество",
                    "short": "ЗАО"
                },
                "name": {
                    "full_with_opf": "ЗАКРЫТОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"ГАЗПРОМНЕФТЬ-АЭРО\"",
                    "short_with_opf": "ЗАО \"ГАЗПРОМНЕФТЬ-АЭРО\"",
                    "latin": null,
                    "full": "ГАЗПРОМНЕФТЬ-АЭРО",
                    "short": "ГАЗПРОМНЕФТЬ-АЭРО"
                },
                "inn": "7714117720",
                "ogrn": "1027700232614",
                "okpo": null,
                "okved": "51.51",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1445904000000,
                    "registration_date": 882230400000,
                    "liquidation_date": 1436400000000
                },
                "address": {
                    "value": "г Санкт-Петербург, ул Галерная, д 5А",
                    "unrestricted_value": "г Санкт-Петербург, ул Галерная, д 5А",
                    "data": {
                        ...
                   }
                }
            }
        },
        {
            "value": "АО \"ГАЗПРОМНЕФТЬ - СЕВЕРО-ЗАПАД\"",
            "unrestricted_value": "АО \"ГАЗПРОМНЕФТЬ - СЕВЕРО-ЗАПАД\"",
            "data": {
                "kpp": "784201001",
                "management": {
                    "name": "Шалимов Олег Михайлович",
                    "post": "Генеральный директор"
                },
                "branch_type": "MAIN",
                "branch_count": 1,
                "type": "LEGAL",
                "opf": {
                    "code": "12267",
                    "full": "Акционерное общество",
                    "short": "АО"
                },
                "name": {
                    "full_with_opf": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"ГАЗПРОМНЕФТЬ - СЕВЕРО-ЗАПАД\"",
                    "short_with_opf": "АО \"ГАЗПРОМНЕФТЬ - СЕВЕРО-ЗАПАД\"",
                    "latin": null,
                    "full": "ГАЗПРОМНЕФТЬ - СЕВЕРО-ЗАПАД",
                    "short": "ГАЗПРОМНЕФТЬ - СЕВЕРО-ЗАПАД"
                },
                "inn": "7827004526",
                "ogrn": "1027812400868",
                "okpo": null,
                "okved": "51.51.2",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1440806400000,
                    "registration_date": 797472000000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "г Санкт-Петербург, ул Херсонская, д 12-14А",
                    "unrestricted_value": "г Санкт-Петербург, ул Херсонская, д 12-14А",
                    "data": {
                        ...
                    }
                }
            }
        },


ИП в Оренбурге

{
    "query": "ип муромова",
    "locations_boost": [{
        "kladr_id":"5600000100000"
    }]
}

Ответ:

{
    "suggestions": [
        {
            "value": "ИП Муромова Татьяна Викторовна",
            "unrestricted_value": "ИП Муромова Татьяна Викторовна",
            "data": {
                "type": "INDIVIDUAL",
                "opf": {
                    "code": "50102",
                    "full": "Индивидуальный предприниматель",
                    "short": "ИП"
                },
                "name": {
                    "full_with_opf": "Индивидуальный предприниматель Муромова Татьяна Викторовна",
                    "short_with_opf": "ИП Муромова Татьяна Викторовна",
                    "latin": null,
                    "full": "Муромова Татьяна Викторовна",
                    "short": null
                },
                "inn": "560300710807",
                "ogrn": "304560314600155",
                "okpo": "0120324962",
                "okved": "52.44.4",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1435708800000,
                    "registration_date": 1085443200000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Россия, Оренбургская область, город Бузулук",
                    "unrestricted_value": "Россия, Оренбургская область, город Бузулук",
                    "data": null
                }
            }
        },
        {
            "value": "ИП Муромова Валентина Георгиевна",
            "unrestricted_value": "ИП Муромова Валентина Георгиевна",
            "data": {
                "type": "INDIVIDUAL",
                "opf": {
                    "code": "50102",
                    "full": "Индивидуальный предприниматель",
                    "short": "ИП"
                },
                "name": {
                    "full_with_opf": "Индивидуальный предприниматель Муромова Валентина Георгиевна",
                    "short_with_opf": "ИП Муромова Валентина Георгиевна",
                    "latin": null,
                    "full": "Муромова Валентина Георгиевна",
                    "short": null
                },
                "inn": "720400333461",
                "ogrn": "304720325400162",
                "okpo": "0127705359",
                "okved": "60.21.11",
                "state": {
                    "status": "ACTIVE",
                    "actuality_date": 1435708800000,
                    "registration_date": 1094774400000,
                    "liquidation_date": null
                },
                "address": {
                    "value": "Россия, Тюменская область, город Тюмень",
                    "unrestricted_value": "Россия, Тюменская область, город Тюмень",
                    "data": null
                }
            }
        },