⚡ API unificada v2.0 AVANZADO

Documentos de la API Unificada v2.0

Experimenta nuestra API unificada de alto rendimiento, diseñada para usuarios avanzados con grandes volúmenes de solicitudes. Consulta múltiples nombres en una sola petición con tiempos de respuesta ultrarrápidos.

API v1.0 SIMPLE

También ofrecemos otra versión de la API con puntos finales que son más fáciles de integrar. Si eres un principiante en la implementación de API's puedes cambiar a nuestro endpoint v1.0.

Ver API v1.0 →

🚀 Herramientas de la API

Explora nuestra API usando herramientas estándar de la industria

Ver documentación Swagger → Importar a Postman →

Consulta por el primer nombre

Consulta por nombre completo

Consulta por correo electrónico

Obtener el país de origen

Obtener estadísticas

Códigos de error

Consulta por correo electrónico

También puede consultar un género utilizando una dirección de correo electrónico que contenga una dirección de correo electrónico:

POST

info Créditos requeridos: 1

link URL

https://gender-api.com/v2/gender

http Headers

Content-Type: application/json

Authorization: Bearer <us fichas de autorización>

link

data_object JSON Payload

Campo	Escriba	Requerido	Descripción
`email`	string	Si	Dirección de correo electrónico para la consulta
`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

code Ejemplos

Consulta por correo electrónico solamente

play_arrow Prueba en vivo con codepen.io

{
    "email": "theresa.miller14@gmail.com"
}

Consulta por correo electrónico y código de país

play_arrow Prueba en vivo con codepen.io

{
    "email": "thomas.clarks@hotmail.com",
    "country": "US"
}

Consulta por dirección de correo electrónico y localización del navegador

play_arrow Prueba en vivo con codepen.io

{
    "email": "Thomas.j32@live.com",
    "locale": "en_US"
}

Consultar por correo electrónico y utilizar una dirección IP para la localización

play_arrow Prueba en vivo con codepen.io

{
    "email": "thomasfromnewyork@gmail.com",
    "ip": "54.201.16.177"
}

Consultar varios nombres en una sola solicitud

play_arrow Prueba en vivo con codepen.io

[
    {
        "email": "thomas.clarks@hotmail.com",
        "country": "US"
    },
    {
        "email": "theresa.miller14@gmail.com"
    }
]

check_circle Respuesta

{
    "input": {
        "email": "theresa.miller14@gmail.com"
    },
    "details": {
        "credits_used": 1,
        "duration": "12ms",
        "samples": 8961,
        "country": null,
        "first_name_sanitized": "theresa"
    },
    "result_found": true,
    "last_name": "Miller",
    "first_name": "Theresa",
    "probability": 0.98,
    "gender": "female"
}

list Campos de respuesta

Campo	Escriba	Descripción
`input`	object	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.email_sanitized`	int	El nombre después de que le aplicamos nuestro normalizador
`details.duration`	string	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
`email`	string	La dirección de correo electrónico que hemos utilizado para la genderización
`probability`	float	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