Spectrum API — единый шлюз для поиска по открытым данным. Поддерживает 12 типов поиска: от ФИО до VIN-номера.
https://api.usespectrum.cfdДля доступа к API требуется ключ. Передавайте его одним из двух способов.
Все доступные методы API.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | Да | Поисковый запрос |
| type | string | Нет | Тип поиска (по умолчанию: fio) |
| key | string | * | API-ключ (если не передан в заголовке) |
| Тип | Описание |
|---|---|
| fio | Поиск по ФИО |
| phone | Поиск по номеру телефона |
| passport | Поиск по паспорту |
| snils | Поиск по СНИЛС |
| inn | Поиск по ИНН |
| tgid | Поиск по Telegram ID |
| car | Поиск по автомобилю |
| vin | Поиск по VIN |
| ogrn | Поиск по ОГРН |
| ogrnip | Поиск по ОГРНИП |
| Поиск по email | |
| address | Поиск по адресу |
Выполнение поискового запроса к API.
curl -s "https://api.usespectrum.cfd/api/v1/search?key=ВАШ_КЛЮЧ&q=Иванов+Иван&type=fio"
# Быстрая проверка валидности API-ключа curl -s "https://api.usespectrum.cfd/api/v1/check-key?key=ВАШ_КЛЮЧ"
API возвращает стандартизированные HTTP-статусы и JSON с описанием ошибки.
| HTTP | Сообщение | Описание |
|---|---|---|
| 400 | Параметр q обязателен | Не передан поисковый запрос |
| 401 | Требуется API-ключ | Ключ не указан ни в заголовке, ни в URL |
| 403 | Неверный API-ключ | Ключ не найден в базе |
| 403 | Срок действия ключа истёк | Ключ просрочен |
| 429 | Превышен лимит. Пауза X мин. | Rate limit + strike-система |
| 500 | ошибка на стороне сервера | Внутренняя ошибка сервера |
При превышении лимита в 100 запросов/минуту включается прогрессивный кулдаун:
| Нарушение | Длительность |
|---|---|
| 1-е | 5 минут |
| 2-е | 10 минут |
| 3-е | 30 минут |
| 4+ | 60 минут |
Ограничения на использование API.
| Лимит | Значение | Детали |
|---|---|---|
| Запросов в минуту | 100 | На один API-ключ |
| Кулдаун | 5 — 60 мин | Прогрессивный при превышении |
| Срок ключа | 7 / 30 / 365 дн. | Или бессрочно по запросу |
Готовые интеграции для вашего проекта.
import requests API_KEY = "ваш_ключ" BASE = "https://api.usespectrum.cfd" response = requests.get( f"{BASE}/api/v1/search", params={"key": API_KEY, "q": "+79991234567", "type": "phone"}, ) if response.status_code == 200: print(response.json()) else: print("Ошибка:", response.status_code, response.text)
const API_KEY = 'ваш_ключ'; const email = 'user@example.com'; try { const res = await fetch( `https://api.usespectrum.cfd/api/v1/search?key=${API_KEY}&q=${encodeURIComponent(email)}&type=email` ); const data = await res.json(); if (data.success) { console.log('Результаты:', data.data); } else { console.error('Ошибка API:', data.error); } } catch (err) { console.error('Сетевая ошибка:', err); }
Нарушение правил ведёт к блокировке API-ключа без возврата средств.
Максимум 100 запросов в минуту на один ключ. При превышении — прогрессивный кулдаун от 5 до 60 минут. Увеличение лимита только через администратора.
Запрещается передавать API-ключ третьим лицам. Ключ предназначен строго для личного использования. При утечке ключ блокируется без предупреждения.
Полученные данные разрешается использовать только в личных целях. Публикация, перепродажа или передача данных третьим лицам строго запрещены.
Разрешена только через официальный API-ключ. Парсинг, скрапинг через Telegram-бота, а также любые недокументированные методы запрещены.
DDoS-атаки, флуд, попытки взлома, подбора ключей или обхода системы авторизации ведут к немедленной и бессрочной блокировке.
По вопросам увеличения лимитов, ошибок, сотрудничества и индивидуальных условий — обращайтесь к администратору через Telegram.