Skip to main content
FaceSearch REST API

Ejecuta búsquedas de rostros desde cualquier lenguaje

La REST API de FaceSearch ofrece a los desarrolladores una superficie pequeña y estable para la búsqueda inversa de rostros: envía una foto, consulta el estado y lee los resultados. Autenticación Bearer, reintentos idempotentes y una especificación OpenAPI pública.

Un endpoint • 3 créditos por búsqueda • JSON en todo momento

Con la confianza de miles en todo el mundo

15.000+ Búsquedas
50+ Países
Cifrado de 256 bits
99,7% de Precisión

Cómo funciona la REST API

Tres pasos entre una terminal en blanco y tu primer resultado de búsqueda.

Crea una clave API
1

Crea una clave API

Inicia sesión en el panel y genera una clave. El texto en claro se muestra una sola vez. Guárdala en tu gestor de secretos y nunca la envíes al control de versiones.

Envía la imagen con POST
2

Envía la imagen con POST

Ejecuta curl -F [email protected] https://facesearch.net/api/v1/search con tu cabecera Bearer. El endpoint devuelve un jobId en menos de un segundo.

Consulta hasta que termine
3

Consulta hasta que termine

Haz GET /api/v1/search/{jobId} cada 3 a 5 segundos. Cuando el estado sea completed, la respuesta incluirá las URLs de origen, las miniaturas y las puntuaciones de confianza.

Funciones de la REST API

Todo lo que necesitas para integrar la búsqueda de rostros en un backend en producción.

REST API face search features visualization

Especificación OpenAPI 3.1

Un documento OpenAPI escrito a mano en /api/v1/openapi.json que alimenta cualquier SDK tipado, desde importaciones de Postman hasta clientes generados en más de 20 lenguajes.

Reintentos idempotentes

Envía la cabecera Idempotency-Key según RFC 9110 y el servidor devolverá el mismo jobId para envíos duplicados. Si la omites, el servidor calcula un hash del contenido automáticamente, así los reintentos ingenuos siempre son seguros.

Cuotas por clave

Cada clave API puede llevar un límite diario y mensual opcional. Una clave filtrada no puede vaciar todo tu saldo porque la cuota se aplica a la velocidad de Redis con respaldo en Postgres.

Límites de tasa granulares

Cada respuesta incluye las cabeceras X-RateLimit-Remaining y X-RateLimit-Reset. Las respuestas 429 traen Retry-After para que sepas con precisión cuándo volver a intentarlo.

Saldo de créditos compartido

El uso de la API se descuenta del mismo saldo que la interfaz web. Una sola recarga en el panel alimenta ambas superficies, sin una nueva SKU de facturación que gestionar.

Errores predecibles

Cada respuesta de error es un sobre estable: code, message, status. Códigos como INSUFFICIENT_CREDITS y RATE_LIMITED nunca cambian, así tu manejo de errores puede ser aburrido y eterno.

Copiar. Pegar. Desplegar.

Cada llamada a la API de FaceSearch es una sola solicitud HTTP. Aquí tiene el mismo flujo de 'enviar una búsqueda de rostro' en cinco lenguajes.

Una línea en la 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"

Quién construye sobre la REST API

Desde verificaciones de antecedentes hasta herramientas de seguridad, la API impulsa equipos que necesitan búsqueda de rostros a gran escala.

Ingeniero de backend integrando la API de FaceSearch
Fintech

Pipelines de verificación de identidad

Los servicios de KYC y onboarding llaman a la API desde su flujo de verificación para confirmar que la foto de una identificación enviada coincide con la persona en otros lugares de la web pública.

Analista de confianza y seguridad ejecutando comprobaciones automatizadas de rostros
Seguridad

Moderación automatizada

Los equipos de confianza y seguridad conectan la API a su pipeline de respuesta a incidentes para enriquecer reportes escalados con contexto en segundos, no en horas.

Investigador ejecutando búsquedas masivas de rostros desde un notebook
Investigación

Investigación periodística

Periodistas de investigación e investigadores OSINT automatizan búsquedas masivas desde notebooks de Jupyter, usando la cabecera de clave de idempotencia para deduplicar lotes que corren de noche.

Plataforma de Búsqueda Facial de Confianza

10M+
Búsquedas completadas
Resultados confiables en todo el mundo
95%
Precisión de coincidencia
Impulsado por IA avanzada
50K+
Usuarios activos
Comunidad en crecimiento
100M+
Fuentes escaneadas
Cobertura completa

Lo que dicen los desarrolladores de la API

Opiniones reales de equipos que integran FaceSearch en sus flujos de producción.

"La política híbrida de clave de idempotencia es la mejor que he visto en una API. Los reintentos ingenuos simplemente funcionan, y las claves explícitas nos dan control total cuando necesitamos búsquedas nuevas."
Priya R.
Staff Engineer, startup fintech
"Integramos FaceSearch en nuestro pipeline de moderación en una tarde. Las cuotas por clave nos permiten dar a cada equipo su propia clave sin preocuparnos de que alguien agote el saldo por accidente."
Marcus T.
Líder de confianza y seguridad
"La especificación OpenAPI me permitió generar un cliente Python tipado con un solo comando. Los códigos de error no cambian, así que mi pipeline lleva meses siendo aburrido, en el mejor sentido."
Yuki H.
Ingeniera de investigación

Precios simples y transparentes

Elige el plan que se adapte a tus necesidades. Sin tarifas ocultas, cancela en cualquier momento.

FREE

$0/mes

Perfecto para empezar

  • Face Search
Empieza gratis
MÁS POPULAR

PRO

$29/mes

Para profesionales y usuarios avanzados

  • 100 Credits per month ($0.29 per credit)
  • Face Search
  • Search History
  • Can Export Profile to PDF
Pago por uso

O compra paquetes de créditos

Starter

3créditos

$6

$2.00/credit

AHORRA 20%

Basic

30créditos

$24

$0.80/credit

AHORRA 31%

Standard

100créditos

$69

$0.69/credit

AHORRA 34%

Pro

300créditos

$199

$0.66/credit

AHORRA 40%

Enterprise

1000créditos

$599

$0.60/credit

Preguntas frecuentes de la REST API

Todo lo que preguntan los desarrolladores antes de escribir su primera llamada.

Empieza a construir con la REST API

Crea una clave API gratuita, pega el comando curl de una línea y ejecuta tu primera búsqueda en menos de diez minutos.

Crear una clave API

No credit card required