Skip to main content
FaceSearch REST API

Запускайте поиск по лицу из любого языка

REST API FaceSearch даёт разработчикам небольшую и стабильную поверхность для обратного поиска по изображению лица: отправьте фото, опросите статус, получите результаты. Аутентификация Bearer, идемпотентные повторы и публичная спецификация OpenAPI.

Один эндпоинт • 3 кредита за поиск • JSON повсюду

Нам доверяют тысячи по всему миру

15 000+ Поисков
50+ Стран
256-битное шифрование
99,7% Точность

Как работает REST API

Три шага от пустого терминала до первого результата поиска.

Создайте API-ключ
1

Создайте API-ключ

Войдите в панель управления и создайте ключ. Открытый текст показывается ровно один раз. Сохраните его в менеджере секретов и никогда не коммитьте в исходный код.

Отправьте изображение через POST
2

Отправьте изображение через POST

Выполните curl -F [email protected] https://facesearch.net/api/v1/search с заголовком Bearer. Эндпоинт вернёт jobId менее чем за секунду.

Опрашивайте до завершения
3

Опрашивайте до завершения

Каждые 3–5 секунд вызывайте GET /api/v1/search/{jobId}. Когда статус станет completed, в ответе будут URL источников, миниатюры и оценки уверенности.

Возможности REST API

Всё, что нужно, чтобы встроить поиск по лицу в продакшен-бэкенд.

REST API face search features visualization

Спецификация OpenAPI 3.1

Написанный вручную документ OpenAPI по адресу /api/v1/openapi.json питает любой типобезопасный SDK — от импорта в Postman до сгенерированных клиентов на 20+ языках.

Идемпотентные повторы

Отправьте заголовок Idempotency-Key согласно RFC 9110, и сервер вернёт тот же jobId для дублирующих отправок. Если заголовок не указан, сервер автоматически вычислит хеш контента, поэтому простые повторы всегда безопасны.

Квоты на ключ

У каждого API-ключа может быть опциональный дневной и месячный лимит. Утечка ключа не сможет обнулить весь баланс: квота применяется на скорости Redis с запасным вариантом на Postgres.

Гранулярные rate limits

В каждом ответе есть заголовки X-RateLimit-Remaining и X-RateLimit-Reset. Ответы 429 содержат Retry-After, так что вы точно знаете, когда повторить запрос.

Общий пул кредитов

Использование API списывается с того же баланса кредитов, что и веб-интерфейс. Одно пополнение в панели питает обе стороны, никаких новых SKU для биллинга.

Предсказуемые ошибки

Каждая ошибка — стабильный конверт: code, message, status. Коды вроде INSUFFICIENT_CREDITS и RATE_LIMITED не меняются, поэтому обработка ошибок может оставаться простой и жить долго.

Скопируйте. Вставьте. Запустите.

Каждый вызов API FaceSearch — это один HTTP-запрос. Вот один и тот же сценарий «отправить поиск лица» на пяти языках.

Однострочник для терминала
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
  -H "Authorization: Bearer fs_live_YOUR_KEY" \
  -H "Idempotency-Key: submit-$(date +%s)" \
  -F "image=@/path/to/face.jpg" \
  -F "consent=true"

# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
  -H "Authorization: Bearer fs_live_YOUR_KEY"

# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
  -H "Authorization: Bearer fs_live_YOUR_KEY"

Кто строит поверх REST API

От проверок контрагентов до инструментов безопасности — API питает команды, которым нужен поиск по лицу в масштабе.

Backend-инженер, интегрирующий API FaceSearch
Финтех

Пайплайны проверки личности

Сервисы KYC и онбординга вызывают API из своего рабочего процесса верификации, чтобы подтвердить, что фото в присланном документе принадлежит тому же человеку, что и на других ресурсах публичного веба.

Аналитик Trust & Safety, запускающий автоматические проверки лиц
Безопасность

Автоматизированная модерация

Команды Trust & Safety подключают API к пайплайну реагирования на инциденты, чтобы эскалированные жалобы получали контекст за секунды, а не за часы.

Исследователь, запускающий массовый поиск по лицам из ноутбука
Исследования

Расследовательские исследования

Журналисты-расследователи и OSINT-исследователи пишут скрипты массового поиска из Jupyter-ноутбуков, используя заголовок ключа идемпотентности, чтобы дедуплицировать ночные пакетные запуски.

Тысячи доверяют поиску по лицу

10М+
Выполненных поисков
Надёжные результаты по всему миру
95%
Точность совпадения
На базе продвинутого ИИ
50К+
Активных пользователей
Растущее сообщество
100М+
Просканированных источников
Всеобъемлющее покрытие

Что разработчики говорят об API

Реальные отзывы команд, интегрирующих FaceSearch в продакшен-процессы.

"Гибридная политика ключей идемпотентности — лучшая, что я видела в каком-либо API. Простые повторы просто работают, а явные ключи дают полный контроль, когда нам нужен действительно новый поиск."
Прия Р.
Staff Engineer, финтех-стартап
"Мы подключили FaceSearch к пайплайну модерации за один день. Квоты на ключ позволяют выдавать разным командам свои ключи, не переживая, что кто-то случайно выжжет весь пул."
Маркус Т.
Trust & Safety Lead
"Спецификация OpenAPI позволила мне сгенерировать типизированный Python-клиент одной командой. Коды ошибок не меняются, поэтому мой пайплайн уже несколько месяцев скучно-стабилен — в лучшем смысле слова."
Юки Х.
Research Engineer

Простое, прозрачное ценообразование

Выберите план, который подходит вашим потребностям. Скрытых плат нет, отмена в любое время.

FREE

$0/месяц

Отлично для начала

САМЫЙ ПОПУЛЯРНЫЙ

PRO

$29/месяц

Для профессионалов и опытных пользователей

  • 100 Credits per month ($0.29 per credit)
  • Face Search
  • Search History
  • Can Export Profile to PDF
Оплата по мере использования

Или купить пакеты кредитов

Starter

3кредитов

$6

$2.00/credit

ЭКОНОМИЯ 20%

Basic

30кредитов

$24

$0.80/credit

ЭКОНОМИЯ 31%

Standard

100кредитов

$69

$0.69/credit

ЭКОНОМИЯ 34%

Pro

300кредитов

$199

$0.66/credit

ЭКОНОМИЯ 40%

Enterprise

1000кредитов

$599

$0.60/credit

FAQ по REST API

Всё, что разработчики спрашивают перед первым запросом.

Начните строить с REST API

Создайте бесплатный API-ключ, вставьте curl-однострочник и запустите первый поиск менее чем за десять минут.

Создать API-ключ

No credit card required