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

Sherk

Один адрес для поиска. Ключ из бота, ответ — JSON.

Старт

1. Откройте бота → Профиль → API → Создать ключ (skay-...).

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

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

Подписка бота не работает через ключ. Для ключа нужны купленные запросы.

Авторизация

Параметр key в каждом запросе.

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

Запрос

GET https://sherk.opik.net/api/v1/search

Параметры

Параметр	Описание
`key`	Ключ `skay-...`
`query`	Username, ID, телефон, ФИО, email, авто, VIN, VK, паспорт, ИНН, СНИЛС, ОГРН
`type`	Тип поиска (таблица ниже)

Примеры

Python

import requests

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

cURL

curl "https://sherk.opik.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"
  }
}

Ошибки

Код	Значение
200	Успех
400	Неверные параметры
401	Неверный ключ
402	Недостаточно запросов
403	Подписка не через ключ
429	Лимит 1 запрос/сек
504	Таймаут поиска

Типы

type	Пример
`username`	`@durov`
`id` / `tgid`	`123456789`
`phone`	`+79991234567`
`fio`	`Иванов Иван 01.01.1990`
`email`	`ivanov@mail.ru`
`car`	`А001АА77`
`vin`	`XTA212130T1186583`
`vk`	`https://vk.com/id1`
`passport`	`6516244966`
`inn`	`383600465404`
`snils`	`11531187016`
`ogrn`	`1027700132195`

Лимиты

1 запрос в секунду на ключ
Списываются купленные запросы
Подписка бота через ключ недоступна