Ir al contenido
POST AI agent ready /v1/nationality/estimate

API de predicción de nacionalidad: estimación del país de origen a partir del nombre

Estima los países de origen más probables para un nombre determinado utilizando modelos estadísticos entrenados en datos demográficos globales. Devuelve una serie de países clasificados por probabilidad con códigos ISO 3166-1 alfa-2. Útil para localización, análisis demográfico e internacionalización.

Parameters

stringrequired

Name (first or last) to predict nationality for.

Code examples

curl -X POST https://api.botoi.com/v1/nationality/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Tanaka"}'

When to use this API

Selección automática de configuración regional e idioma

Cuando un nuevo usuario se registra solo con su nombre, predice su probable país de origen y establece de forma predeterminada el idioma de la interfaz y la configuración regional en consecuencia. Un usuario llamado "Tanaka" vería el japonés como idioma sugerido, lo que le ahorraría un paso de selección manual.

Investigación de mercado y análisis de audiencia.

Analice la distribución de nacionalidades de su base de usuarios o lista de correo electrónico ejecutando nombres a través de este punto final en lotes. Identifique en qué países tiene más repercusión su producto y asigne presupuestos de marketing a las regiones con mayores oportunidades.

KYC y preselección de verificación de identidad

Durante la incorporación de KYC, compare la nacionalidad prevista con el país de residencia declarado o el país del pasaporte. Una gran discrepancia no es fraude en sí misma, pero puede desencadenar pasos de verificación adicionales en su modelo de riesgo.

Frequently asked questions

¿Puedo usar nombres, apellidos o nombres completos?
El punto final funciona con cualquier entrada de nombre. Los apellidos (apellidos) a menudo producen señales de nacionalidad más distintivas que los nombres. Puede pasar el nombre, el apellido o el nombre completo, aunque las entradas de un solo token (un nombre a la vez) tienden a ser más precisas.
¿Qué significa la puntuación de probabilidad?
Cada país en la respuesta tiene una probabilidad entre 0 y 1 que representa la probabilidad de que una persona con ese nombre sea originaria de ese país. Una probabilidad de 0,85 para JP significa que el 85% de las personas con ese nombre en el conjunto de datos son de Japón.
¿Cuántos países se devuelven?
La respuesta incluye hasta 5 países clasificados por probabilidad. Solo se incluyen los países con una probabilidad no despreciable (superior a ~0,01). Los nombres fuertemente asociados con un país pueden arrojar menos resultados.
¿Por qué "Tanaka" muestra a Brasil como partido secundario?
Brasil tiene la diáspora japonesa más grande fuera de Japón. Nombres como "Tanaka" aparecen en registros brasileños debido a la inmigración japonesa a principios del siglo XX. El modelo refleja distribuciones de nombres en el mundo real entre países.
¿Se normaliza el nombre antes de procesarlo?
Sí. Los nombres están en minúsculas y sin espacios en blanco. Las marcas diacríticas se conservan y contribuyen a la predicción, ya que los caracteres acentuados llevan señales de nacionalidad (por ejemplo, "Muller" frente a "Mueller").

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs