API Docs Unified API v2.0

API v1.0

We also offer another API version with endpoints that are easier to integrate. If you're a beginner in implementing API's you can switch to our v1.0 endpoint.

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:

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
email string Si Email address to query
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 por correo electrónico solamente
{"email":"theresa.miller14@gmail.com"}
Consulta por correo electrónico y código de país
{"email":"thomas.clarks@hotmail.com","country":"US"}
Consulta por dirección de correo electrónico y localización del navegador
{"email":"Thomas.j32@live.com","locale":"en_US"}
Consultar por correo electrónico y utilizar una dirección IP para la localización
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Consultar varios nombres en una sola solicitud
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Respuesta
{
    "input": {
        "email": "Sandra"
    },
    "details": {
        "credits_used": 1,
        "samples": 464,
        "country": null,
        "email_sanitized": "sandra",
        "duration": "436ms"
    },
    "result_found": true,
    "email": "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.email_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
email string La dirección de correo electrónico que hemos utilizado para la genderización
probability int 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.
Chat

Cookies

We use cookies (including third-party cookies) to collect information about visitors' use of our website. These cookies help us to provide you with the best possible online experience and to constantly improve our websites. Information collected via cookies may also be processed outside the European Union, for example, in the USA. By clicking the "Accept All" button, you agree to the use of cookies. To withdraw your consent at any time, change your settings or for more information about the use of cookies, click here or "Cookie Settings" at the end of the page.