Документация API
Простой и мощный REST API для всех типов поиска
POST
/api/search
Универсальный поиск по различным параметрам
Заголовки запроса
X-API-Key: "your_api_key" Content-Type: "application/json"
Примеры по языкам программирования
import requests api_key = "your_api_key" headers = { "X-API-Key": api_key, "Content-Type": "application/json" } payload = { "query": "89991234567", "search_type": "phone" } response = requests.post( "https://nightsearch.life/api/search", json=payload, headers=headers ) print(response.json())
const response = await fetch('https://nightsearch.life/api/search', { method: 'POST', headers: { 'X-API-Key': 'your_api_key', 'Content-Type': 'application/json' }, body: JSON.stringify({ query: '89991234567', search_type: 'phone' }) }); const data = await response.json(); console.log(data);
curl - X POST "https://nightsearch.life/api/search" \ - H "X-API-Key: your_api_key" \ - H "Content-Type: application/json" \ - d '{ "query": "89991234567", "search_type": "phone" }'
<?php $api_key = 'your_api_key'; $headers = [ 'X-API-Key: ' . $api_key, 'Content-Type: application/json' ]; $payload = json_encode([ 'query' => '89991234567', 'search_type' => 'phone' ]); $ch = curl_init('https://nightsearch.life/api/search'); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $payload); curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); echo $response; ?>
Пример успешного ответа
{ "status": "success", "quest": "77777777777", "results": [ { "database": "название базы", "description": "описание базы", "fields": [ { "key": "ФИО", "value": "Иванов Иван Иванович" }, { "key": "Номер", "value": "77777777777" }, { "key": "Регион", "value": "Москва" }, { "key": null, "value": "Дополнительная информация" } ] }, { "database": "название базы", "description": "описание базы", "fields": [ { "key": "Дата регистрации", "value": "2026-11-05" } ] } ] }
Доступные типы поиска
| Тип (search_type) | Описание | Пример запроса |
|---|---|---|
phone |
Поиск по номеру телефона | "query": "+79991234567" |
email |
Поиск по email адресу | "query": "user@example.com" |
fio |
Поиск по ФИО (имени и фамилии) | "query": "Иван Петров" |
vk |
Поиск по VKontakte (ID или username) | "query": "123456789" или "username" |
tg |
Поиск по Telegram (ID или username) | "query": "123456789" или "@username" |
ip |
Поиск по IP адресу | "query": "192.168.1.1" |
snils |
Поиск по СНИЛС | "query": "12345678901" |
inn |
Поиск по ИНН организации/физ. лица | "query": "7712345678" |
nick |
Поиск по никнейму (альтернатива для VK) | "query": "username" |
car |
Поиск по VIN номеру автомобиля | "query": "JTHBF5C14A5034814" |
ok |
Поиск по Одноклассникам (ID или username) | "query": "12345678" или "username" |
fb |
Поиск по Facebook (ID или username) | "query": "100001234567890" или "username" |
GET
/api/status
Проверить статус аккаунта и остаток лимитов
Пример запроса
curl - X GET "https://nightsearch.life/api/status" \ - H "X-API-Key: your_api_key"
Пример ответа
{ "success": true, "plan": "Professional", "searches_used": 234, "searches_limit": 5000, "searches_remaining": 4766, "reset_date": "2024-01-17", "status": "active" }
ERROR
Коды ошибок
Возможные HTTP коды ошибок и их значения
| Код | Значение | Описание |
|---|---|---|
200 |
OK | Запрос выполнен успешно |
400 |
Bad Request | Неверный формат запроса или отсутствуют обязательные параметры |
401 |
Unauthorized | API ключ отсутствует или неверный |
403 |
Forbidden | У вас нет доступа к этому ресурсу или достигнут лимит запросов |
404 |
Not Found | Данные по вашему запросу не найдены |
429 |
Too Many Requests | Вы отправили слишком много запросов. Подождите перед следующим запросом |
500 |
Internal Server Error | Ошибка сервера. Попробуйте позже |
503 |
Service Unavailable | Сервис временно недоступен. Попробуйте позже |