> API de búsqueda facial con IA: envía una foto y recibe los perfiles públicos donde aparece, con puntuación de confianza. Un crédito por búsqueda, sin suscripción. **API DE ESCANEO FACIAL IA** # ESCANEO FACIAL CON IA, DESDE TU PROPIO CÓDIGO. Una **API de búsqueda facial inversa** sobre la web pública. Envía una foto de una cara y recibe las páginas y perfiles donde aparece, cada uno con una puntuación de confianza y un enlace. Un crédito por búsqueda, con precio en dólares, sin suscripción y sin mínimo mensual. Sin llamada de ventas · Sin mínimo mensual · Los créditos no caducan También en [RapidAPI](https://rapidapi.com/muratcankuruoffical/api/trace-reverse-face-search-api) · [especificación OpenAPI](https://traceaifacescan.app/openapi.json) · [ejemplos de código en GitHub](https://github.com/muratcankuruoffical/reverse-face-search-api) · [Hugging Face Space](https://huggingface.co/spaces/muratcankuru/reverse-face-search) · [Apify Actor](https://apify.com/muratcankuru/reverse-face-search) - Resultados en aproximadamente un minuto - Un crédito por búsqueda - REST + JSON, nada que instalar - Motor propio, no un revendedor **QUÉ HACE LA API** ## UNA FOTO ENTRA. TODAS LAS COINCIDENCIAS PÚBLICAS SALEN. El mismo motor que usa el panel, con los mismos resultados. La API no es una versión reducida. **BÚSQUEDA FACIAL INVERSA** ### Coincide con una cara, no con un archivo. Una búsqueda inversa de imágenes normal encuentra copias de la misma imagen. Esto coincide con la cara, así que una foto distinta de la misma persona — otra ropa, otro año — sigue apareciendo como resultado. **PUNTUACIÓN DE CONFIANZA** ### Cada coincidencia lleva un número. Cada resultado tiene una puntuación de similitud de 50 a 100 y una banda: posible desde 70, fuerte desde 80, casi certeza desde 90. Nada se devuelve como un veredicto. **USUARIOS DE REDES SOCIALES** ### La cuenta, no solo la página. Cuando la URL pertenece a una cuenta, el usuario y la plataforma vuelven como campos separados — sin que tengas que analizar URLs por tu cuenta. **MOTOR PROPIO** ### No somos un revendedor. Trace opera su propio servicio de búsqueda facial. Por eso una búsqueda cuesta céntimos y no dólares, y por eso no tenemos que limitar tus solicitudes. **INICIO RÁPIDO** ## TRES LLAMADAS, DE PRINCIPIO A FIN. La autenticación es una sola cabecera. No hay SDK que instalar ni protocolo de enlace. ### Iniciar un escaneo Multipart, nombre de campo `image`. JPEG, PNG o WebP, hasta 8 MB, con al menos 200px en el lado corto. `Idempotency-Key` es opcional y hace que un reintento sea seguro. ```bash curl -X POST https://traceaifacescan.app/api/v1/scans \ -H "Authorization: Bearer trk_live_..." \ -H "Idempotency-Key: $(uuidgen)" \ -F image=@face.jpg ``` **202 ACCEPTED** ```json { "id": "01m0jr1j5cbhwqsnt5qjx3zyd8", "status": "queued", "progress": 0, "locked": false, "match_count": 0, "credits_remaining": 9 } ``` ### Consultar hasta que termine Una búsqueda tarda entre 25 y 45 segundos. Consulta cada uno o dos segundos hasta que `status` sea `done` o `failed`. ```bash curl https://traceaifacescan.app/api/v1/scans/01m0jr1j5cbhwqsnt5qjx3zyd8 \ -H "Authorization: Bearer trk_live_..." ``` **200 OK** ```json { "status": "done", "progress": 100, "locked": false, "match_count": 2, "matches": [ { "score": 88, "tier": "strong", "platform": "x", "handle": "@alexrivers88", "url": "https://x.com/alexrivers88", "preview_url": ".../scans/01m0.../previews/0" } ] } ``` ### Gastar el crédito Un escaneo creado sin créditos disponibles vuelve `locked: true` sin coincidencias — no se buscó nada. Revelar es una llamada separada a propósito: un script que recorre una lista de escaneos no debería poder vaciar tu saldo por accidente. ```bash curl -X POST \ https://traceaifacescan.app/api/v1/scans/01m0.../reveal \ -H "Authorization: Bearer trk_live_..." ``` **ENDPOINTS** ## TODA LA SUPERFICIE. Siete endpoints. La definición legible por máquina está en [openapi.json](https://traceaifacescan.app/openapi.json), y la referencia completa con los cuerpos de respuesta está en [la documentación](https://traceaifacescan.app/docs). - **POST** — `/v1/scans` — Iniciar un escaneo a partir de una foto. - **GET** — `/v1/scans/{id}` — Estado, progreso y coincidencias. - **GET** — `/v1/scans` — Tus escaneos, paginados. - **POST** — `/v1/scans/{id}/reveal` — Gastar un crédito y ejecutar la búsqueda real. - **GET** — `/v1/scans/{id}/previews/{n}` — La miniatura de la cara de una coincidencia. - **DELETE** — `/v1/scans/{id}` — Eliminar el escaneo, su imagen y sus vistas previas. - **GET** — `/v1/account` — Tu saldo de créditos. **ERRORES Y LÍMITES** ## FALLOS PREDECIBLES. Los errores vuelven como `application/problem+json` con una cadena `code` estable. Compara con el código, nunca con el mensaje. - **402** — `insufficient_credits` — No quedan créditos. No se buscó nada y no se cobró nada. - **404** — `no_face_detected` — No hay cara en la imagen. Prueba otra foto, no un reintento. - **429** — `rate_limited` — Solo tras fallos repetidos de autenticación. `Retry-After` indica cuándo. - **401** — `unauthorized` — Clave ausente, incorrecta o revocada. - **503** — `provider_unavailable` — Error nuestro. Un crédito reservado para una búsqueda fallida siempre se devuelve. ### Límites - **Sin límite de velocidad de solicitudes.** Las lecturas no se cuentan y no hay un tope por minuto. - Tu límite real es tu **saldo de créditos**: un escaneo cuesta un crédito, una lectura no cuesta nada. - Imágenes de hasta **8 MB**, con al menos **200px** en el lado corto. - Los escaneos y sus imágenes se eliminan tras **30 días**. `DELETE` lo hace al instante. **PRECIOS** ## UN CRÉDITO, UNA BÚSQUEDA. Los mismos créditos que usa el panel, del mismo saldo. Sin suscripción, sin mínimo mensual, y no caducan nunca. El paquete de 100 créditos es sobre el que está construida la API. Se compran con tarjeta, con Telegram Stars o con criptomoneda — mira [los paquetes de créditos](https://traceaifacescan.app/es/#pricing). ¿Necesitas más volumen que el paquete más grande? [Escríbenos](https://docs.google.com/forms/d/e/1FAIpQLSdVeyYm3BLWkEnmHToK5_JQynOHCctKTxMkBJp3PJf-pmaLYQ/viewform). **LÍMITES HONESTOS** ## LO QUE ESTA API NO HARÁ. **No es un servicio de identidad.** Una coincidencia es una puntuación de similitud entre dos imágenes, no una afirmación sobre quién es alguien. No hay nombre, dirección, número de teléfono ni registro de ningún tipo en la respuesta — solo URLs públicas y un número. **Un resultado vacío no es prueba de ausencia.** Significa que no se encontró nada en la parte de la web pública a la que podemos acceder. Si la persona no tiene ninguna foto pública, no hay nada que encontrar, y ninguna API puede cambiar eso. **No se toca nada detrás de un inicio de sesión.** Cada resultado es una página que ya era pública. **No debe usarse para verificación de antecedentes, contratación, préstamos, seguros, vigilancia ni aplicación de la ley**, ni contra menores. Envía solo fotos que tengas derecho a buscar. Esto está en las [Condiciones de Uso](https://traceaifacescan.app/es/terminos/) y lo hacemos cumplir — una clave usada así se revoca. **FAQ** ## LO QUE LOS DESARROLLADORES PREGUNTAN PRIMERO. ### ¿Qué es una API de escaneo facial con IA? Es una API HTTP que toma una fotografía de una cara y devuelve los demás lugares de internet público donde aparece esa misma cara. A diferencia de una búsqueda inversa de imágenes, que compara archivos de imagen, un escaneo facial con IA compara la geometría facial — así que identifica a la misma persona en una foto completamente distinta. La versión de Trace es una API REST con respuestas JSON: un POST para iniciar un escaneo, un GET para leer las coincidencias. ### ¿Cuánto cuesta una búsqueda facial a través de la API? Un crédito por búsqueda, y los créditos se compran en paquetes con precio en dólares estadounidenses — desde $4 por cinco créditos hasta $50 por 100. No hay suscripción, ni mínimo mensual, ni caducidad. La API gasta el mismo saldo que el panel. ### ¿Tienen un nivel gratuito o una prueba? No hay búsqueda gratuita en la API. Una solicitud de API desde una cuenta sin créditos crea el escaneo pero no lo busca: vuelve bloqueado sin coincidencias. El panel le muestra a un visitante registrado un resultado de ejemplo estático para que vea la forma de un caso terminado, y la API deliberadamente nunca devuelve eso — un marcador de posición es algo sobre lo que un script podría construir. ### ¿Qué tan rápida es una búsqueda? Entre 25 y 45 segundos de principio a fin, a veces hasta 90. Por eso la API es asíncrona: POST devuelve 202 de inmediato con un id, y lo consultas. Mantener abierta una solicitud HTTP durante un minuto convertiría una conexión cerrada en una búsqueda cancelada. ### ¿Puedo usar URLs de imágenes en lugar de subir un archivo? No en v1. Aceptar una URL convertiría la API en un proxy SSRF — estaríamos obteniendo direcciones arbitrarias en nombre de quien llama desde dentro de nuestra red. Si vuelve, será con una lista de permitidos y rangos privados rechazados. ### ¿La API tiene límite de frecuencia? No. Llámala tan rápido como tu código pueda — las lecturas no se cuentan y no hay un tope por minuto. Lo único que te limita es tu saldo de créditos, porque un escaneo cuesta un crédito y una lectura no cuesta nada. Queda un único freno de seguridad que una clave válida nunca ve: los intentos repetidos de autenticación fallida desde la misma dirección se ralentizan, así que adivinar claves sigue siendo costoso. ### ¿Es legal usar una API de búsqueda facial? Depende completamente de para qué la uses y de dónde estés. Verificar que una foto en tu propia plataforma pertenece a la persona que la usa es algo distinto de construir una base de datos de caras. Los datos faciales son una categoría especial bajo el RGPD y la KVKK, y tú eres el responsable de lo que nos envíes. Lee las Condiciones de Uso: la verificación de antecedentes, la contratación, los préstamos, los seguros, la vigilancia y la aplicación de la ley están todos fuera de los límites. ### ¿Es esta una API de reconocimiento facial o una API de búsqueda inversa de imágenes? Es una API de búsqueda facial, que es un tipo específico de reconocimiento facial. No compara dos fotos que tú proporciones, no verifica un documento de identidad ni devuelve nada sobre quién es una persona. Toma una fotografía y busca en la web pública otras imágenes de esa misma cara, devolviendo cada coincidencia como una URL pública con una puntuación de similitud. Eso es también lo que la diferencia de una API de búsqueda inversa de imágenes: la búsqueda inversa de imágenes coincide con el archivo de imagen, así que encuentra copias de esa imagen exacta, mientras que esta coincide con la geometría facial y encuentra la misma cara en una foto distinta. **API DE ESCANEO FACIAL IA** ## EMPIEZA CON UNA LLAMADA. Crea una clave en el panel y el primer curl funciona de inmediato.