API Docs Unificado API

Consulta por el primer nombre
Consulta por nombre completo
Consulta por correo electrónico
Obtener el país de origen
Obtener estadísticas
Detalles del problema

Consulta por el primer nombre

Esta es la forma más fácil de consultar un género por un nombre. Cada respuesta está codificada con JSON:

Publicar
Créditos requeridos: 1
URL
https://gender-api.com/v2/gender
Headers
Content-Type: application/json
Authorization: Bearer <us fichas de autorización>
link
JSON Payload
Campo Escriba Requerido Descripción
first_name string Si Nombre a consultar
country string No ISO 3166 ALPHA-2 Código de país
link
locale string No Navegador Local
ip string No Dirección IPv4 o IPv6 válida
id string No Máximo 50 caracteres. Puede configurar esta identificación a cualquier valor alfanumérico que desee. Como ejemplo, puede establecer el id a su id interno del conjunto de datos en su base de datos. En un asíncrono ambiente esto puede ayudar a conectar mejor la respuesta a una solicitud anterior

Ejemplos

Consulta sólo por el primer nombre
play_arrow Prueba en vivo con codepen.io 
{"first_name":"Sandra"}
Consulta por nombre y código de país
play_arrow Prueba en vivo con codepen.io 
{"first_name":"Sandra","country":"US"}
Consulta por nombre y ubicación del navegador
play_arrow Prueba en vivo con codepen.io 
{"first_name":"Sandra","locale":"en_US"}
Consultar por el nombre de pila y utilizar una dirección IP para la localización
play_arrow Prueba en vivo con codepen.io 
{"first_name":"Sandra","ip":"54.201.16.177"}
Consultar varios nombres en una sola solicitud
play_arrow Prueba en vivo con codepen.io 
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
Respuesta
{
    "input": {
        "first_name": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "first_name_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "first_name": "Sandra",
    "probability": 0.85,
    "gender": "female"
}
Campo Escriba Descripción
input array La carga útil enviada
details.credits_used int La cantidad de créditos utilizados para esta consulta
details.samples int Número de registros encontrados en nuestra base de datos que coinciden con su solicitud
details.country string El país que encontramos
details.first_name_sanitized int El nombre después de que le aplicamos nuestro normalizador
details.duration int El tiempo que el servidor necesitaba para procesar la solicitud
result_found bool Es cierto que si pudiéramos consultar el género del primer nombre
first_name string El primer nombre que usamos para la genderización
probability string Este valor (entre 0 y 1) determina la fiabilidad de nuestra base de datos. Un valor de 1 significa que los resultados de su solicitud de género son 100% exactos.
gender string Valores posibles: masculino, femenino, desconocido
Este producto incluye datos de GeoLite2 creados por MaxMind, disponibles en http://www.maxmind.com.
Utilizamos cookies y tecnologías similares para reconocer sus visitas repetidas y sus preferencias, así como para medir la eficacia de las campañas y analizar el tráfico.
Puedes aprender más sobre los cookies que usamos o editarlos aquí.
NEGAR ACEPTO