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.
Milhares de buscas
Disponível no mundo todo
Criptografia de 256 bits
Alta precisão de correspondência
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.
- Com o que você busca
- Uma foto que contenha um rosto. Não existe busca por texto.
- O que você recebe
- Páginas ordenadas onde aparece um rosto correspondente, cada uma com pontuação de confiança e link para a fonte.
- Como uma correspondência é feita
- Reconhecimento facial. O rosto é convertido em um embedding — uma lista de números — e comparado por distância, não por nome de arquivo, legenda ou pixels. Como funciona o reconhecimento facial?
- Custo por busca
- 3 créditos. Contas novas começam com 3 créditos gratuitos e sem cartão de crédito.
- Retenção das fotos
- Os envios são excluídos em até 24 horas após a conclusão da busca.
Como a REST API funciona
Três passos entre um terminal vazio e seu primeiro resultado de busca.
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.
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.
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.
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.
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
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
10 MB
Tamanho máximo de upload
Imagens JPEG, PNG ou WebP
24 h
Retenção de imagens
Uploads excluídos automaticamente
24/7
Disponibilidade de busca
Busque a qualquer momento
3
Créditos por busca
Preços simples e transparentes
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
- 60 créditos por mês ($0.48 por crédito)
- Busca Facial
- Histórico de Buscas
- Pode exportar perfil para PDF
Ou Compr Pacotes de Créditos
Pague conforme usar
Starter
3créditos
$6
$2.00/crédito
ECONOMIZE 20%
Basic
30créditos
$24
$0.80/crédito
ECONOMIZE 31%
Standard
100créditos
$69
$0.69/crédito
ECONOMIZE 34%
Pro
300créditos
$199
$0.66/crédito
ECONOMIZE 40%
Enterprise
1000créditos
$599
$0.60/crédito
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
Não é necessário cartão de crédito
