Fintech
Pipelines de verificação de identidade
Serviços de KYC e onboarding chamam a API a partir do fluxo de verificação para confirmar se a foto do documento enviado bate com a pessoa em outros lugares da web pública.
FaceSearch REST API
Execute buscas de rostos a partir de qualquer linguagem
A REST API do FaceSearch oferece aos desenvolvedores uma superfície pequena e estável para busca reversa de imagem facial: envie uma foto, consulte o status e leia os resultados. Autenticação Bearer, tentativas idempotentes e spec OpenAPI pública.
Um endpoint • 3 créditos por busca • JSON em todo lugar
Confiado por milhares no mundo todo
15.000+ Pesquisas
50+ Países
Criptografia de 256 bits
99,7% de Precisão
Como a REST API funciona
Três passos entre um terminal vazio e seu primeiro resultado de busca.
1
Crie uma chave API
Faça login no painel e gere uma chave. O texto em claro é exibido uma única vez. Guarde-a no seu gerenciador de segredos e nunca a versione junto ao código.
2
Envie sua imagem via POST
Rode curl -F [email protected] https://facesearch.net/api/v1/search com o cabeçalho Bearer. O endpoint devolve um jobId em menos de um segundo.
3
Consulte até a conclusão
Chame GET /api/v1/search/{jobId} a cada 3 a 5 segundos. Quando o status for completed, a resposta trará as URLs de origem, miniaturas e pontuações de confiança.
Recursos da REST API
Tudo o que você precisa para integrar a busca de rostos a um backend em produção.
Recursos da REST API
Tudo o que você precisa para integrar a busca de rostos a um backend em produção.
Spec OpenAPI 3.1
Um documento OpenAPI escrito à mão em /api/v1/openapi.json que alimenta qualquer SDK tipado, de importações no Postman a clientes gerados em mais de 20 linguagens.
Tentativas idempotentes
Envie o cabeçalho Idempotency-Key da RFC 9110 e o servidor devolverá o mesmo jobId para envios duplicados. Sem o cabeçalho, o servidor gera um hash de conteúdo automaticamente, então retentativas ingênuas são sempre seguras.
Cotas por chave
Cada chave API pode ter um limite diário e mensal opcionais. Uma chave vazada não consegue esgotar todo o seu saldo porque a cota é aplicada na velocidade do Redis, com fallback em Postgres.
Limites de taxa granulares
Toda resposta traz os cabeçalhos X-RateLimit-Remaining e X-RateLimit-Reset. As respostas 429 incluem Retry-After, então você sabe exatamente quando tentar de novo.
Pool de créditos compartilhado
O uso da API sai do mesmo saldo de créditos da interface web. Uma única recarga no painel alimenta as duas superfícies, sem nenhum novo SKU de cobrança para gerenciar.
Erros previsíveis
Toda resposta de erro é um envelope estável: code, message, status. Códigos como INSUFFICIENT_CREDITS e RATE_LIMITED nunca mudam, então seu tratamento de erro pode ser previsível e durar para sempre.
Copie. Cole. Faça deploy.
Cada chamada à API do FaceSearch é uma única requisição HTTP. Aqui está o mesmo fluxo de 'enviar uma busca de rosto' em cinco linguagens.
Uma linha no terminal
# 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"Quem constrói sobre a REST API
De verificações de antecedentes a ferramentas de segurança, a API impulsiona equipes que precisam de busca de rostos em escala.
Segurança
Moderação automatizada
Times de confiança e segurança conectam a API ao seu pipeline de resposta a incidentes para enriquecer denúncias escaladas com contexto em segundos, não horas.
Pesquisa
Pesquisa investigativa
Jornalistas investigativos e pesquisadores OSINT automatizam buscas em massa a partir de notebooks Jupyter, usando o cabeçalho de chave de idempotência para deduplicar execuções noturnas.
Plataforma de Busca Facial Confiável
10M+
Buscas Concluídas
Resultados confiáveis globalmente
95%
Precisão de Correspondência
Alimentado por IA avançada
50K+
Usuários Ativos
Comunidade em crescimento
100M+
Fontes Varridas
Cobertura abrangente
O que desenvolvedores dizem sobre a API
Feedback real de times que integram o FaceSearch a seus fluxos de produção.
"A política híbrida de chave de idempotência é a melhor que já vi em qualquer API. As retentativas ingênuas simplesmente funcionam, e as chaves explícitas nos dão controle total quando precisamos de buscas realmente novas."
"Conectamos o FaceSearch ao nosso pipeline de moderação em uma tarde. As cotas por chave nos deixam entregar chaves diferentes para cada time sem medo de alguém esvaziar o pool por acidente."
"A spec OpenAPI permitiu gerar um cliente Python tipado com um único comando. Os códigos de erro não mudam, então meu pipeline está previsível há meses — no melhor sentido."
Preços Simples e Transparentes
Escolha o plano que atende às suas necessidades. Sem taxas ocultas, cancele a qualquer momento.
MAIS POPULAR
PRO
$29/mês
Para profissionais e usuários avançados
- 100 Credits per month ($0.29 per credit)
- Face Search
- Search History
- Can Export Profile to PDF
Pague conforme usar
Ou Compr Pacotes de Créditos
Starter
3créditos
$6
$2.00/credit
ECONOMIZE 20%
Basic
30créditos
$24
$0.80/credit
ECONOMIZE 31%
Standard
100créditos
$69
$0.69/credit
ECONOMIZE 34%
Pro
300créditos
$199
$0.66/credit
ECONOMIZE 40%
Enterprise
1000créditos
$599
$0.60/credit
Perguntas frequentes da REST API
Tudo o que os desenvolvedores perguntam antes de escrever a primeira requisição.
Comece a construir com a REST API
Crie uma chave API gratuita, cole o curl de uma linha e execute a sua primeira busca em menos de dez minutos.
Criar uma chave API
No credit card required
