Документация API

Добро пожаловать в DepSearch API. Поиск данных по ФИО, телефону, email, IP, VIN, СНИЛС, ИНН, адресу и другим параметрам. Все ответы в формате JSON.

Base URL
https://api.depsearch.sbs

Авторизация

Каждый запрос требует токен доступа. Передавайте его через GET-параметр &token=.

GET-параметр
https://api.depsearch.sbs/quest=значение&token=ВАШ_ТОКЕН

Поиск по ФИО

Любая строка из кириллических слов без спецсимволов трактуется как ФИО. Теперь в одном запросе можно передать ФИО вместе с годом рождения, полной датой и/или городом — всё распознаётся автоматически, без отдельных параметров.

GET Полное ФИО
https://api.depsearch.sbs/quest=Иванов Иван Иванович&token=TEST
GET ФИО + год рождения
https://api.depsearch.sbs/quest=Иванов Иван Иванович 1985&token=TEST
GET ФИО + полная дата рождения + город
https://api.depsearch.sbs/quest=Иванов Иван 15.03.1985 Москва&token=TEST
GET Фамилия Имя + город + год
https://api.depsearch.sbs/quest=Иванов Иван Краснодар 1985&token=TEST
GET Фамилия Имя + г. Город
https://api.depsearch.sbs/quest=Иванов Иван г. Новосибирск&token=TEST
GET Только Фамилия Имя
https://api.depsearch.sbs/quest=Иванов Иван&token=TEST

Поддерживаемые форматы даты рождения

1985              — год рождения
15.03.1985        — полная дата (ДД.ММ.ГГГГ)
1985-03-15        — ISO-формат (через &dob=)

Город можно указывать как Москва, так и г. Москва — оба варианта распознаются.

Поиск по телефону

Распознаётся автоматически. Пробелы, скобки, плюс и дефисы — не важны. Для российских номеров дополнительно возвращается блок phone_info с оператором, регионом и местным временем.

GET По номеру телефона
https://api.depsearch.sbs/quest=79277231370&token=TEST

Поддерживаемые форматы

79277231370
+79277231370
+7 (927) 723-13-70
89277231370

Пример ответа

{
  "phone_info": {
    "phone":     "+7 927 723-13-70",
    "operator":  "ПАО «МегаФон»",
    "region":    "Самарская обл.",
    "timezone":  "SAMT (UTC+4)",
    "local_time":"21:11"
  },
  "results": [...]
}

Поиск по Email

Распознаётся автоматически по наличию символа @. Регистр не важен.

GET По email
https://api.depsearch.sbs/quest=user@gmail.com&token=TEST

Поиск по никнейму

Используйте префикс nick:.

GET По никнейму / логину
https://api.depsearch.sbs/quest=nick:username123&token=TEST

Поиск по паролю

Используйте префикс pass:.

GET По паролю
https://api.depsearch.sbs/quest=pass:qwerty123&token=TEST

Поиск по СНИЛС

Префикс snils + 11 цифр без пробелов.

GET По СНИЛС
https://api.depsearch.sbs/quest=snils12345678901&token=TEST

Поиск по ИНН

Префикс inn + номер. Физлицо — 12 цифр, юрлицо — 10 цифр.

GET По ИНН
https://api.depsearch.sbs/quest=inn582801503237&token=TEST

Авто (ГРЗ / VIN)

ГРЗ и VIN распознаются автоматически. Латиница в номере конвертируется в кириллицу.

GET Государственный номер (ГРЗ)
https://api.depsearch.sbs/quest=A123BC77&token=TEST
GET VIN-код (17 символов)
https://api.depsearch.sbs/quest=1HGBH41JXMN109186&token=TEST

Поиск по IP адресу

IPv4 распознаётся автоматически. Можно использовать префикс ip:. Возвращает геолокацию, провайдера, часовой пояс и флаги прокси/хостинга.

GET По IP адресу
https://api.depsearch.sbs/quest=8.8.8.8&token=TEST
https://api.depsearch.sbs/quest=ip:8.8.8.8&token=TEST

Пример ответа

{
  "ip_info": {
    "country":    "США",
    "city":       "Mountain View (California)",
    "reverse_dns":"dns.google",
    "provider":   "Google LLC",
    "timezone":   "America/Los_Angeles",
    "coords":     "37.4056, -122.0775",
    "is_proxy":   "Возможно",
    "is_hosting": "Да"
  },
  "results": [...]
}

ВКонтакте

Поиск по VK ID. Поддерживается несколько форматов.

GET По VK ID
https://api.depsearch.sbs/quest=vkid123456789&token=TEST
https://api.depsearch.sbs/quest=vk.com/id123456789&token=TEST
https://api.depsearch.sbs/quest=https://vk.com/id123456789&token=TEST

Поиск по адресу БЕТА

Временно открытое бета-тестирование. Используйте префикс г., addr: или адрес: — роутер распознаёт адрес автоматически. Запрос должен содержать хотя бы город и улицу.

GET Полный адрес с квартирой
https://api.depsearch.sbs/quest=г. Москва, ул. Тверская, д. 10, кв. 25&token=TEST
GET С префиксом addr: (work 100%)
https://api.depsearch.sbs/quest=addr:Санкт-Петербург, пр-кт Луначарского, д. 54&token=TEST
GET С префиксом адрес:
https://api.depsearch.sbs/quest=адрес:Краснодар, ул. Красная, д. 1&token=TEST

Поддерживаемые префиксы

г. Город, ...     — автоопределение по «г.»
addr:...          — латинский префикс
адрес:...         — кириллический префикс

Пример ответа

{
  "results": {
    "city":    "Москва",
    "street": "ул. Тверская",
    "house":  "д. 10",
    "flat":   "кв. 25"
  },
  "info": [...]
}
⚠ Бета-функция. В период тестирования покрытие базы может быть неполным. Результаты могут отличаться от финальной версии.

Перевод полей

Добавьте &lang=ru к любому запросу — названия полей в results будут переведены на русский язык.

GET Запрос с переводом
https://api.depsearch.sbs/quest=79277231370&token=TEST&lang=ru

Пример ответа

{
  "results": [
    {
      "✉️Почта":   "[email protected]",
      "📞Телефон":  "79277231370",
      "👤ФИО":      "Иванов Иван Иванович",
      "🏫Источник": "Название базы"
    }
  ]
}

Коды ошибок

200 OK

Запрос выполнен успешно.

400 Bad Request

Неверный формат значения.

401 Unauthorized

Токен не передан.

403 Forbidden

Неверный токен.

429 Too Many Requests

Превышен лимит. Смотрите заголовок Retry-After.

500 Server Error

Внутренняя ошибка. Повторите позже.

Лимиты запросов

Каждый токен ограничен 70 запросами в минуту. При превышении возвращается код 429.

Пример ответа 429
{
  "error": "Превышен лимит запросов (70/мин). Попробуйте через 23 сек."
}

Статус API

Публичный эндпоинт. Токен не нужен.

GET /status
https://api.depsearch.sbs/status
{ "status": "ok" }        — всё работает
{ "status": "degraded" }  — частичный сбой