⚡ API unificada v2.0 AVANZADO

API DOCUMENTATION

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.

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:

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

info Créditos requeridos: 1

http Headers

Content-Type: application/json

Authorization: Bearer <us fichas de autorización>

link

data_object 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

code Request Examples

arrow_forward Consulta sólo por el primer nombre

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra"
}

arrow_forward Consulta por nombre y código de país

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra",
    "country": "US"
}

arrow_forward Consulta por nombre y ubicación del navegador

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra",
    "locale": "en_US"
}

arrow_forward Consultar por el nombre de pila y utilizar una dirección IP para la localización

play_arrow Try Live On Codepen.io

{
    "first_name": "Sandra",
    "ip": "54.201.16.177"
}

arrow_forward Consultar varios nombres en una sola solicitud

play_arrow Try Live On Codepen.io

[
    {
        "first_name": "Sandra",
        "country": "US"
    },
    {
        "first_name": "Jason",
        "country": "US"
    }
]

check_circle 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"
}

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.first_name_sanitized`	string	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
`first_name`	string	El primer nombre que usamos 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