Начало работы

Добро пожаловать в Sherk

Единый API для поиска по Telegram, VK, телефонам, email, паспортам, ИНН, СНИЛС, авто и многому другому через один эндпоинт.

Быстрый старт

Получите API-ключ в Telegram-боте и отправьте первый запрос за 2 минуты.

Авторизация

Все запросы требуют API-ключ, передаётся параметром key.

Типы поиска

13 типов: username, ID, телефон, ФИО, email, авто, VIN, VK, паспорт, ИНН, СНИЛС, ОГРН.

Лимиты

1 запрос в секунду. Тратятся только купленные запросы. Подписка не через API.

Что такое Sherk?

Sherk предоставляет единый API-эндпоинт для поиска по Telegram, VK и различным российским базам данных. Один ключ для поиска по телефону, имени, email, паспорту, авто и многому другому.

Баланс запросов (queries) общий для Telegram-бота и API. Купить запросы можно в боте или получить от администратора.

Подписка не работает через API. Подписка (899 руб/мес безлимит) — только в боте. Для API покупайте пакеты запросов.

Быстрый старт

1. Получите ключ

Откройте Sherk Bot в Telegram. Профиль -> API -> Создать ключ. Формат: skay-...

2. Отправьте запрос

curl "http://sherk.sytes.net/api/v1/search?key=skay-KEY&query=@durov&type=username"

3. Получите результат

JSON-ответ с полными данными профиля: ID, username, телефон, имя, био и многое другое.

Авторизация

Передайте API-ключ параметром key. Пример:

http://sherk.sytes.net/api/v1/search?key=skay-ваш_ключ&query=@durov&type=username

Получите ключ в боте: Профиль -> API -> Создать ключ

Эндпоинт

GET http://sherk.sytes.net/api/v1/search

Параметры

Параметр	Тип	Описание
`key`	string	Ваш API-ключ (`skay-...`)
`query`	string	Запрос: @username, ID, телефон, ФИО, email, гос номер, VIN, VK, паспорт, ИНН, СНИЛС или ОГРН
`type`	string	Тип поиска (см. ниже)

Примеры

Python

import requests

r = requests.get("http://sherk.sytes.net/api/v1/search", params={
    "key": "skay-ваш_ключ",
    "query": "@durov",
    "type": "username"
})
print(r.json())

cURL

curl "http://sherk.sytes.net/api/v1/search?key=skay-abc123&query=@durov&type=username"

Ответ

Успех

{
  "ok": true,
  "balance": 47,
  "data": {
    "id": 123456789,
    "username": "@durov",
    "phone": "+79991234567",
    "first_name": "Pavel",
    "verified": true,
    ...
  }
}

Не найдено

{
  "ok": true,
  "balance": 47,
  "data": null,
  "message": "Не найдено"
}

Ошибка

{
  "ok": false,
  "error": "Недостаточно запросов"
}

Коды ошибок

HTTP	Описание
200	Успех
400	Неверные параметры
401	Неверный ключ
402	Недостаточно запросов
403	Подписка не работает через API
429	Лимит: 1 запрос в секунду
504	Превышено время поиска

Типы поиска

type	Формат query	Пример
`username`	@username	`@durov`
`id`	Число	`123456789`
`tgid`	Число	`123456789`
`phone`	+7/+380/+375...	`+79991234567`
`fio`	Кириллица 2+ слов	`Иванов Иван 01.01.1990`
`email`	email	`ivanov@mail.ru`
`car`	Гос номер	`А001АА77`
`vin`	17 символов	`XTA212130T1186583`
`vk`	Ссылка VK / ID	`https://vk.com/id266518653`
`passport`	10 цифр	`6516 244966`
`inn`	10 или 12 цифр	`383600465404`
`snils`	11 цифр	`11531187016`
`ogrn`	13 или 15 цифр	`1027700132195`

Лимиты

1 запрос в секунду на ключ
Тратятся только купленные запросы (queries)
Подписка не через API (403)