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

О CRYVEN API

Единый REST API для поиска информации по 10+ параметрам. Высокая скорость, структурированный JSON, поддержка LITE/PRO/FULL уровней.

Основные возможности

GET

/api/v1?key=...&search=...&type=...

Основной эндпоинт v1. Все параметры передаются в query string. Поддержка всех типов поиска.

LITE / PRO / FULL

Уровни глубины

Выбор уровня детализации: от базовой информации до полного анализа из всех источников.

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

GET

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

GET /api/v1?key=CRYVEN_DEMO_KEY&search=+79991234567&type=phone&method=lite

Ответ: JSON с найденными данными или ошибкой.

Демо-ключ

Используйте CRYVEN_DEMO_KEY для тестирования. Лимит: 10 запросов/день, только phone, email, lite.

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

Тип	Описание	Пример
`phone`	Номер телефона	+79991234567
`email`	Email адрес	user@example.com
`fio`	ФИО	Иванов Иван Иванович
`telegram`	Telegram юзернейм или ID	@ivan или 123456789
`snils`	СНИЛС	123-456-789 00
`inn`	ИНН	123456789012
`vk`	ID ВКонтакте	123456
`ip`	IP-адрес	192.168.1.1
`auto`	Номер авто	А123БВ777
`nick`	Никнейм	hacker1337

Уровни метода

LITE

Быстрый ответ, основная информация

PRO

Расширенный анализ, дополнительные источники

FULL

Полный сбор данных из всех доступных баз

API v2

Что такое API v2?

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

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

Параметр	Описание	Пример
`+79991234567`	Номер телефона	+7 (999) 123-45-67
`user@example.com`	Email адрес	test@mail.com
`snils123456789`	СНИЛС	123-456-789 00
`inn123456789012`	ИНН	123456789012
`vkid123456`	ID ВКонтакте	vkid1
`vk.com/username`	Ссылка ВКонтакте	vk.com/durov
`tgid123456`	Telegram ID	tgid1
`t.me/username`	Telegram ссылка	t.me/durov
`okid123456`	Одноклассники ID	okid1
`fcid123456`	Facebook ID	fcid1
`A123BC77`	Гос. номер авто	А123БВ777
`1HGBH41JXMN109186`	VIN код	1HGBH41JXMN109186

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

GET

/api/v2?key=...&search=...

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

Параметры:

key - ваш API ключ CRYVEN (обязательно)
search - поисковый запрос (обязательно)

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

{

  "success": true,

  "results": [

    {

      "fio": "Иванов Иван Иванович",

      "phone": 79991234567,

      "region": "Москва"

    }

  ],

  "search_time": 0.45

}

Коды ошибок

401 Unauthorized - неверный или истёкший API ключ
400 Bad Request - отсутствует параметр 'search'
404 Not Found - данные не найдены в базе
500 Server Error - внутренняя ошибка сервера

Примеры кода

Python

import requests



url = "http://cryven.info/api/v1"

params = {

    "key": "CRYVEN_DEMO_KEY",

    "search": "+79991234567",

    "type": "phone",

    "method": "lite"

}



response = requests.get(url, params=params)

data = response.json()

print(data)

JavaScript (fetch)

const url = new URL('http://cryven.info/api/v1');

url.searchParams.set('key', 'CRYVEN_DEMO_KEY');

url.searchParams.set('search', '+79991234567');

url.searchParams.set('type', 'phone');

url.searchParams.set('method', 'lite');



fetch(url)

  .then(res => res.json())

  .then(data => console.log(data))

  .catch(console.error);

cURL

Командная строка

curl "http://cryven.info/api/v1?key=CRYVEN_DEMO_KEY&search=+79991234567&type=phone&method=lite"

API v2

Python

Пример v2

import requests



url = "http://cryven.info/api/v2"

params = {

    "key": "YOUR_API_KEY",

    "search": "+79991234567"

}



response = requests.get(url, params=params)

data = response.json()

print(data)

cURL

v2 запрос

curl "http://cryven.info/api/v2?key=YOUR_API_KEY&search=+79991234567"