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

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

Base URL
https://api.depsearch.sbs

Авторизация

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

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

Поиск по ФИО

Любая строка из слов без цифр и спецсимволов автоматически трактуется как ФИО. Можно уточнить поиск датой рождения через параметр &dob=.

GET Полное ФИО
https://api.depsearch.sbs/quest=Иванов Иван Иванович&token=TEST
GET Полное ФИО + дата рождения
https://api.depsearch.sbs/quest=Иванов Иван Иванович&dob=1990-05-15&token=TEST
GET Фамилия и имя
https://api.depsearch.sbs/quest=Иванов Иван&token=TEST
GET Фамилия и имя + дата рождения
https://api.depsearch.sbs/quest=Иванов Иван&dob=1990-05-15&token=TEST
GET Только имя
https://api.depsearch.sbs/quest=Иван&token=TEST
GET Только имя + дата рождения
https://api.depsearch.sbs/quest=Иван&dob=1990-05-15&token=TEST

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

Распознаётся автоматически. Пробелы, скобки, плюс и дефисы — не важны. Для российских номеров дополнительно возвращается блок 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

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

Добавьте &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" }  — частичный сбой