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

Что такое API v2?

Расширенный поисковый API для поиска по телефону, email, СНИЛС, ИНН, Telegram, VK, OK, Facebook и номерам автомобилей (ГРЗ/VIN).

API v2 автоматически определяет тип запроса — вам не нужно указывать параметр type вручную.

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

+79991234567Телефон

[email protected]Email

snils123456789СНИЛС

inn123456789012ИНН

vkid123456ВКонтакте ID

vk.com/usernameВКонтакте URL

tgid123456Telegram ID

t.me/usernameTelegram URL

okid123456Одноклассники

fcid123456Facebook

A123BC77ГРЗ

1HGBH41JXMN109186VIN

Пример запроса

HTTP

GET /api/v2?key=KRAMPUS_DEMO_KEY&search=+79991234567

Параметр Описание

key Ваш API ключ KRAMPUS (обязательно)

search Поисковый запрос (обязательно)

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

JSON

{
  "success": true,
  "results": [
    {
      "fio": "Иванов Иван Иванович",
      "phone": 79991234567,
      "region": "Москва"
    }
  ],
  "search_time": 0.45
}

Коды ошибок

401Unauthorized — неверный или истёкший API ключ

400Bad Request — отсутствует параметр 'search'

404Not Found — данные не найдены в базе

500Server Error — внутренняя ошибка сервера

Примеры кода

Python

import requests

url = "http://krampus-ink.icu/api/v2"
params = {
    "key": "YOUR_API_KEY",
    "search": "+79991234567"
}

response = requests.get(url, params=params)
data = response.json()
print(data)

JavaScript (fetch)

JavaScript

const url = new URL('http://krampus-ink.icu/api/v2');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('search', '+79991234567');

fetch(url)
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(console.error);

cURL

Bash

curl "http://krampus-ink.icu/api/v2?key=YOUR_API_KEY&search=+79991234567"