PREGUNTAS FRECUENTES

¿QUé PASA SI UN NOMBRE PUEDE SER TANTO MASCULINO COMO FEMENINO?

Dependiendo de la versión de su API o de la integración que esté utilizando, nuestros puntos finales devolverán una precisión o un valor de probabilidad en la respuesta. El parámetro de precisión devuelve la seguridad de que este nombre es masculino o femenino. El valor se calcula en función del número de registros de nuestra base de datos. Por ejemplo, si tenemos 100 muestras de un nombre, 96 son mujeres y 4 son hombres, la precisión es del 96% (o una probabilidad de 0,96). Una precisión baja indica que este nombre es probablemente utilizado por múltiples géneros y no puede ser conjugado a un género específico.

¿PUEDE HABER DIFERENCIAS PARA UN MISMO NOMBRE POR PAíS?

Mientras que el nombre Andrea es masculino en Italia, Andrea es un nombre femenino en Alemania e incluso puede ser ambos en Estados Unidos. En este caso, proporcionamos un valor de precisión en el resultado de la consulta, que oscila entre 0 y 100 (o un valor de probabilidad entre 0 y 1). Le indica la certeza de que hemos detectado el género correcto. Puede aumentar significativamente la calidad de los resultados de la API proporcionando alguna información geográfica sobre su consulta. Puede tratarse de un código de país, la configuración regional del navegador o una dirección IP. Puede obtener más información sobre la localización de una consulta en nuestros Documentos API.

¿CóMO RECOGES LOS DATOS?

Para ofrecer la mayor precisión posible, combinamos datos de múltiples fuentes. Las principales fuentes de nuevos registros son los datos disponibles públicamente, datos gubernamentales y adiciones/correcciones manuales. En función de la fuente de un nombre nuevo, es posible que el nombre tenga que ser verificado por una segunda fuente antes de añadirlo a nuestra lista. Por ejemplo, si añadimos un nombre a partir de datos disponibles públicamente, este nombre puede necesitar una segunda verificación, como una confirmación manual, antes de que se añada finalmente a nuestra base de datos. Puede encontrar una lista de los países admitidos aquí.

¿CON QUé FRECUENCIA ACTUALIZAN LOS REGISTROS DE NOMBRES?

Actualizamos periódicamente nuestros datos en función del país y de los datos públicos disponibles. En la mayoría de los países occidentales se actualizan una vez al año. Además, la distribución de nombres entre géneros puede cambiar con los años. Por ejemplo, si un nombre era utilizado exclusivamente por mujeres en los años 70, puede que décadas más tarde sea utilizado predominantemente por hombres. Por eso también utilizamos datos de nacimientos de varios países, como Estados Unidos, para enriquecer los resultados. Nuestros modelos intentan tener en cuenta todos estos factores lo mejor posible. El valor de precisión devuelto se ajusta periódicamente para reflejar el uso real en la población lo más preciso posible. Se supone que el valor proporciona una evaluación razonable basada en las últimas décadas y puede expresar una posible fluctuación. Nos fijamos en las últimas 4 décadas de los datos. Si ejecuta una consulta y repite la misma consulta un año después, es posible que obtenga un resultado diferente porque nuestro sistema puede que se hayan eliminado datos antiguos y se hayan añadido datos nuevos. Cada vez que se añaden nuevos datos, realizamos a continuación las llamadas pruebas de integración. En este proceso, nuestra API se prueba con un conjunto de datos previamente validados para garantizar la calidad. Este conjunto de datos se amplía continuamente con nombres y casos de prueba para lograr la cobertura más amplia posible.

¿PROPORCIONA ALGUNA AYUDA PARA IMPLEMENTAR EL API?

Sí, ofrecemos asistencia por correo electrónico a todos los clientes. Puede enviarnos un correo electrónico a contact gender-api.com. Nos pondremos en contacto con usted lo antes posible. También puede encontrar ejemplos de codificación aquí. Tenga en cuenta que no podemos ayudarle con todos los lenguajes de programación y casos de uso. En la mayoría de los casos, puede utilizar un cliente rest estándar en su aplicación para consultar nuestra API. Muchas bibliotecas también admiten la importación de un archivo de definición OpenAPI. Puede descargar nuestro archivo de definición openapi.yml aquí.

¿Y SI NECESITAMOS UN ALTO NIVEL DE PRECISIóN?

Languages and names are fluid and change over time. From customer to customer, data sets also vary a lot in quality, scope and origin. Therefore, we cannot guarantee that all results you receive from our API are 100% correct and match your data pool. But we can promise that we are always committed to providing you with the best results possible and that we regularly improve and update our algorithms. We also add new data on a very regular basis. You can find out more about our updates here. In the unlikely event of our service not matching up with your expectations, we give you a straightforward 14-day money-back guarantee. Of course, we also offer to test our service completely free of charge. If you sign up here, you will receive 100 requests for free every month. If you query a name, our endpoints will either return an accuracy or a probability value in the response, depending on your API version. The accuracy parameter returns how sure we are that this name is either male or female. The value is calculated by the number of records for this in our database. Since use cases differ significantly, we do not give any recommendations on the level of accuracy. Depending on your use case, it is up to you to decide what results and accuracy levels to accept. Even with an accuracy of at least 99%, there is a possibility that the result is incorrect. However, a value above 95% fits most use cases in general.

¿CUáNTOS NOMBRES TIENE ALMACENADOS EN SU BASE DE DATOS?

Nuestra base de datos contiene 6,084,389 nombres validados de 191 diferentes países. En todo el mundo almacenamos 6,198,036 nombres únicos. En promedio analizamos alrededor de 10.000.000 de conjuntos de datos por mes para mejorar la calidad de nuestros resultados.

¿QUé PAíSES RECIBEN ASISTENCIA?

El API apoya plenamente a los países de 191. El soporte completo significa que hemos recogido al menos los nombres de los en este respectivo país. Sin embargo, en la mayoría de los países nuestro conjunto de datos es mucho mayor. Echa un vistazo a la siguiente tabla para aprender más sobre cuántos nombres apoyamos en qué país. Tenga en cuenta que si no proporcionamos un apoyo adecuado para un país nosotros mismos, todavía puede rastrear los nombres solicitados contra el conjunto de datos completo para obtener un resultado adecuado.
1.
Andorra
1,342
2.
United Arab Emirates
24,000
3.
Afghanistan
3,657
4.
Albania
9,928
5.
Armenia
2,560
6.
Angola
17,608
7.
Argentina
18,725
8.
Austria
18,058
9.
Australia
16,329
10.
Azerbaijan
7,973
11.
Bosnia and Herzegovina
6,282
12.
Barbados
689
13.
Bangladesh
18,448
14.
Belgium
48,156
15.
Burkina Faso
5,373
16.
Bulgaria
7,938
17.
Bahrain
7,563
18.
Burundi
1,316
19.
Benin
8,416
20.
Brunei
1,201
21.
Bolivia
2,965
22.
Brazil
93,465
23.
Bahamas
971
24.
Botswana
3,981
25.
Belarus
5,455
26.
Belize
585
27.
Canada
26,187
28.
Congo - Kinshasa
2,119
29.
Congo - Brazzaville
7,835
30.
Switzerland
37,788
31.
Côte d’Ivoire
29,601
32.
Chile
11,353
33.
Cameroon
17,532
34.
China
46,378
35.
Colombia
25,550
36.
Costa Rica
4,055
37.
Cuba
2,354
38.
Cape Verde
3,251
39.
Cyprus
6,631
40.
Czech Republic
28,020
41.
Germany
92,526
42.
Djibouti
2,956
43.
Denmark
12,322
44.
Dominican Republic
7,348
45.
Algeria
41,590
46.
Ecuador
8,125
47.
Estonia
3,570
48.
Egypt
26,773
49.
Western Sahara
403
50.
Spain
300,734
51.
Ethiopia
5,964
52.
Finland
8,663
53.
Fiji
1,564
54.
Micronesia
396
55.
France
208,218
56.
Gabon
5,275
57.
United Kingdom
105,368
58.
Georgia
2,670
59.
French Guiana
1,498
60.
Ghana
16,393
61.
Gibraltar
685
62.
Greenland
337
63.
Gambia
1,724
64.
Guinea
1,982
65.
Guadeloupe
1,193
66.
Equatorial Guinea
1,528
67.
Greece
21,689
68.
Guatemala
3,993
69.
Guam
533
70.
Guyana
672
71.
Hong Kong SAR China
11,574
72.
Honduras
2,759
73.
Croatia
5,376
74.
Haiti
1,630
75.
Hungary
20,347
76.
Indonesia
107,059
77.
Ireland
11,509
78.
Israel
14,677
79.
India
149,630
80.
Iraq
15,966
81.
Iran
15,702
82.
Iceland
2,822
83.
Italy
118,384
84.
Jersey
721
85.
Jamaica
2,866
86.
Jordan
9,461
87.
Japan
39,530
88.
Kenya
16,962
89.
Kyrgyzstan
2,623
90.
Cambodia
3,704
91.
Comoros
974
92.
South Korea
51,070
93.
Kuwait
18,370
94.
Kazakhstan
7,126
95.
Laos
1,622
96.
Lebanon
14,202
97.
Saint Lucia
593
98.
Liechtenstein
366
99.
Sri Lanka
11,671
100.
Liberia
1,252
101.
Lesotho
1,135
102.
Lithuania
4,217
103.
Luxembourg
4,734
104.
Latvia
3,309
105.
Libya
4,513
106.
Morocco
52,767
107.
Monaco
955
108.
Moldova
3,511
109.
Montenegro
1,751
110.
Madagascar
5,853
111.
Macedonia
5,892
112.
Mali
5,697
113.
Myanmar [Burma]
7,184
114.
Mongolia
1,389
115.
Martinique
1,023
116.
Mauritania
1,892
117.
Malta
3,718
118.
Mauritius
7,320
119.
Maldives
1,811
120.
Malawi
1,961
121.
Mexico
33,427
122.
Malaysia
46,913
123.
Mozambique
9,859
124.
Namibia
4,092
125.
New Caledonia
613
126.
Niger
2,466
127.
Nigeria
101,869
128.
Nicaragua
2,459
129.
Netherlands
57,468
130.
Norway
13,165
131.
Nepal
5,793
132.
New Zealand
6,060
133.
Oman
12,514
134.
Panama
3,382
135.
Peru
15,609
136.
French Polynesia
730
137.
Papua New Guinea
1,401
138.
Philippines
37,394
139.
Pakistan
22,909
140.
Poland
25,763
141.
Puerto Rico
4,527
142.
Palestinian Territories
3,968
143.
Portugal
44,374
144.
Paraguay
2,478
145.
Qatar
10,433
146.
Réunion
6,210
147.
Romania
32,764
148.
Serbia
11,751
149.
Russia
49,964
150.
Rwanda
3,757
151.
Saudi Arabia
70,408
152.
Seychelles
1,006
153.
Sudan
7,360
154.
Sweden
29,095
155.
Singapore
19,257
156.
Saint Helena
2,469
157.
Slovenia
5,277
158.
Slovakia
9,364
159.
Sierra Leone
1,246
160.
San Marino
492
161.
Senegal
17,514
162.
Somalia
1,276
163.
Suriname
688
164.
São Tomé and Príncipe
486
165.
El Salvador
5,072
166.
Syria
6,672
167.
Swaziland
879
168.
Chad
829
169.
Togo
6,000
170.
Thailand
93,345
171.
Tajikistan
1,243
172.
Timor-Leste
488
173.
Turkmenistan
1,002
174.
Tunisia
23,123
175.
Turkey
112,624
176.
Trinidad and Tobago
2,003
177.
Taiwan
35,140
178.
Tanzania
8,548
179.
Ukraine
18,808
180.
Uganda
10,927
181.
United States
169,208
182.
Uruguay
2,862
183.
Uzbekistan
3,332
184.
Venezuela
17,889
185.
U.S. Virgin Islands
449
186.
Vietnam
30,496
187.
Yemen
6,352
188.
Mayotte
543
189.
South Africa
50,459
190.
Zambia
3,796
191.
Zimbabwe
4,627

DO YOU SUPPORT ARABIC NAMES?

Yes, our API supports Arabic names. They can also be written in chars from the Arabic alphabet. Arabic is written from right to left in a cursive style and includes 28 letters. As an example, if you query "عبد ال" you will get the following result: "gender": "male" , "accuracy": 100. The arabic name "عبد ال" is urlencoded in this example and the query url would look like: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY. You can find a full list of supported countries here.

ME ENTERé DE SU API DE CORREO ELECTRóNICO. ¿QUé ES ESTO EXACTAMENTE?

Nuestra API de correo electrónico puede extraer nombres de direcciones de correo electrónico y proporcionar la apropiada género a esta dirección respectiva. Esto puede ayudarte a personalizar tus correos electrónicos con un saludo adecuado. Por ejemplo, de la dirección de correo electrónico "marie.johnson@gmail.com", la API extraerá el nombre "Marie" y determinará el el género correcto, que es "femenino". Para más detalles, por favor, eche un vistazo a nuestros API Docs.

TENGO UNA GRAN CANTIDAD DE DATOS. ¿PUEDO SUBIR EN MASA UN ARCHIVO CSV?

Como usuario registrado puedes subir cualquier archivo CSV que contenga una columna de nombre. Para un mejor resultado de la determinación, puede opcionalmente añadir una columna de país a su conjunto de datos. Aunque no es necesario nombrar específicamente las columnas, nuestro asistente le guía a través de la proceso permitiéndole elegir qué columna contiene qué ficha, nombre o país se incluye. La característica se encuentra dentro de u cuenta. Los registros procesados serán cobrados como solicitudes para que puedas subir un archivo CSV con hasta 100 entradas gratis cada mes. La subida masiva de CSV requiere una cuenta Gender-API.com. Por razones de protección de datos, los archivos subidos se borrarán automáticamente después de un año.

¿CóMO SE FORMATEARá EL ARCHIVO CSV?

Admitimos archivos CSV creados en Windows, MacOS o Linux. Además, admitimos archivos con delimitadores como ";", "," o un tabulador. El carácter de delimitación debe ser un ". Además, puede cargar archivos CSV multilínea con un máximo de 10.000.000 de filas y 301MB. Recomendamos utilizar un archivo CSV con formato UTF-8 y un punto y coma como delimitador para obtener los mejores resultados posibles. De lo contrario, el archivo CSV puede contener más filas arbitrarias, que también se incluirán en el archivo de salida. El archivo debe tener al menos una columna con sólo primeros nombres o una columna con nombres completos. Haga clic aquí para descargar un archivo de muestra. Por favor, cree una cuenta Gender-API.com para cargar un archivo CSV.

¿PUEDO SUBIR UN ARCHIVO DE EXCEL?

Puedes subir archivos de Excel con hasta 300.000 filas. Para conjuntos de datos más grandes, por favor use nuestro archivo CSV. Soportamos archivos .xlsx con una sola hoja. Si subes un archivo con más de una hoja, sólo se procesará la primera. La primera fila de tu hoja debe contener los nombres de las columnas. El archivo debe contener al menos una columna con los nombres de pila, la columna del país es opcional. Por razones de protección de datos, los archivos cargados se borrarán automáticamente después de un año. Descargue el archivo de muestra aquí. Ejemplo:
Ejemplo de Excel

¿PROPORCIONA BIBLIOTECAS PARA LOS LENGUAJES DE PROGRAMACIóN?

Debido a la simplicidad de nuestra API, no proporcionamos una libra para ningún lenguaje de programación, excepto el jQuery Plugin. La mayoría de los lenguajes soportan un analizador json fuera de la caja y para casi todos los demás idiomas, ya hay una liberación externa que puede utilizar. Echa un vistazo a nuestros ejemplos de codificación para empezar a usar la API:

Primero instala nuestra biblioteca con el compositor:

$ composer require gender-api/client
use GenderApi\Client as GenderApiClient;

try {
    $apiClient = new GenderApiClient('insert your API key');

    // Query a single name
    $lookup = $apiClient->getByFirstName('elisabeth');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // female
    }

    // Query a full name and improve the result by providing a country code
    $lookup = $apiClient->getByFirstNameAndLastNameAndCountry('Thomas Johnson', 'US');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // male
        echo $lookup->getFirstName();   // Thomas
        echo $lookup->getLastName();    // Johnson
    }

} catch (GenderApi\Exception $e) {
    // Name lookup failed due to a network error or insufficient remaining requests
    // left. See https://gender-api.com/en/api-docs/error-codes
    echo 'Exception: ' . $e->getMessage();
}

Vea la documentación completa del cliente aquí:

https://github.com/markus-perl/gender-api-client

Primero instala nuestra biblioteca con NPM:

Vea la documentación completa del cliente aquí:

https://github.com/markus-perl/gender-api-client-npm

Primero instala nuestra biblioteca con NPM:

Vea la documentación completa del cliente aquí:

https://github.com/markus-perl/gender-api-client-npm

Descargue un proyecto de muestra aquí:

Documentación:

https://github.com/microknights/Gender-API

¿CóMO SE CUENTAN LAS SOLICITUDES?

Every account will be recharged to 100 requests on the first day of every month if there are less than this number of requests left. Only if a result is found, the request will be counted. One name lookup will be counted as one request. If multiple names are requested in one query, each name will be counted as a single request.

¿DóNDE PUEDO ENCONTRAR Y GESTIONAR MIS CLAVES API?

We generate an initial API key when you sign up for a Gender-API.com account. You can find this API key at the bottom of your account overview page. If you want to revoke this key, click on the "Revoke and Regenerate" button. Our system will then invalidate the existing API key and will generate a new one. All your applications that use the old token will then be unable to access our API until you replace this code with the new API key. Captura de pantalla del cuadro de la clave API You can also create more than one API key. This is useful, for example, if you have multiple applications in which you want to include our API. Please note there is no distinction between the keys and how many requests it has used. All requests are counted collectively. To manage or create multiple API keys, click on the "Settings" button in the account menu and then on "API Keys". Gestionar varias claves API By clicking on the button "Create New Key", you can generate a new API key. You can give every token a name to later identify more easily where this key has been used. You can change this name at any time. Also, some of our widgets will auto-generate a key hereg. For example, if you use our "Quick Lookup Widget" in your account, our system will generate a key in advance, and this widget will then use this token to query our API. Furthermore, third-party apps will create a key here once they are connected. Every token can be revoked at any time by simply clicking on the "x". Once revoked, the connected application will no longer have access to our API.

¿PUEDO COMPARTIR MI CUENTA CON VARIAS PERSONAS?

You can share your account with up to 50 more colleagues or other people connected to your project in your account. To manage your team, log into your account and, in the account menu, click on "Settings" => "Manage Your Team". On this page, click on the "Invite a new member" button to invite people via email to your team. When inviting members, you can choose between two different account types. A) Users can view, create, update and delete API keys, upload and genderize CSV and Excel files, access all API endpoints, buy requests and connect third-party apps. B) Administrators can do the same things users can, plus update account settings and billing address, create and view data processing agreements, invite, update and delete team members.

¿PUEDO PROTEGER MI CUENTA ACTIVANDO LA VERIFICACIóN EN DOS PASOS?

Puede proteger su cuenta activando la verificación en dos pasos. Para activar esta medida de seguridad adicional, inicie sesión en su cuenta y, en el menú de cuentas, haga clic en "Configuración" =>. "Cambiar contraseña / 2FA". Asegúrate de tener instalada una aplicación de autenticación en tu teléfono. Te recomendamos que utilices una aplicación como Authy (App Store, Play Store) o Google Authenticator (App Store, Play Store). A continuación, haz clic en el botón "Activar ahora" y sigue las instrucciones que aparecen en pantalla. Aquí puedes añadir varios dispositivos para asegurarte, por ejemplo, de que sigues teniendo acceso a tu cuenta tras perder un dispositivo. Una vez activado, se te pedirá que introduzcas el código generado por la aplicación de autenticación de tu teléfono para iniciar sesión correctamente.

¿PUEDO UTILIZAR APLICACIONES DE TERCEROS CON LA VERIFICACIóN EN DOS PASOS ACTIVADA?

Algunas integraciones o aplicaciones de terceros funcionan perfectamente con la verificación en dos pasos activada. Otras pueden requerir para conectarte sin verificación en dos pasos. Si tienes problemas para iniciar sesión en alguna aplicación con tus credenciales de Gender-API.com, inicia sesión en tu cuenta en Gender-API directamente. y haz clic en "Configuración" => "Cambiar contraseña / 2FA" en el menú de la cuenta. A continuación, haz clic en la pestaña "Verificación en dos pasos" y establece "Acceso a aplicaciones de terceros" en "No restringido". Tenga en cuenta que sólo puede cambiar esta configuración si la verificación en dos pasos está activada.

¿CUáL ES LA DIFERENCIA ENTRE UNA CUENTA DE PAGO Y UNA GRATUITA?

Both account types offer the same functionality. All API endpoints are available for both account types and will return the same results. Free accounts are limited to a certain amount of requests per month. When you sign up, 100 requests are immediately available to you for free. On the first day of each month, our system will reset this number, and the free requests will be available again. Please create only one account. If you need more requests, you can upgrade to one of our paid plans at any time here.

¿CUáL ES LA DIFERENCIA ENTRE UNA SUSCRIPCIóN Y UN PAGO úNICO?

If you want to buy one of our packages, you can choose between a one-time payment, or subscribing to this package. Subscriptions are recommended if you want to use our service regularly. You can be assured that there are always enough remaining requests in your account. Requests purchased with a subscription can be used within one month. With an active subscription, our system will recharge your account after one month to the selected amount of requests. For example, if you are subscribed to our 25,000 requests package and have used 21,500, our system will replenish your account to 25,000 requests after one month. One-time packages can be purchased for a single use case and can be used within one year. For example, if you want to process an Excel or CSV file, we recommend the one-time purchase. One-time purchases do not renew. You have to make sure to not run out of requests. You can switch between both package types on our purchase page. Tipos de compra Please don't mix both purchase types until you have talked to our support first or know exactly what you are doing. Buying a one-time package while you're subscribed to one of our packages can prevent the subscription from refilling your requests. For example, when there are more requests left from the one-time purchase, than the subscription would refill.

HOW CAN I BUY A PACKAGE / MORE REQUESTS?

You can choose between either a subscription plan or a one-time-payment here. One-time-payment is recommended, if you want to process a large CSV file or if you prefer to use your requests on an irregular basis. You can charge your account with the required amount of requests at any time. Requests bought with one-time-payment can be used within one year. If you prefer to sign up for a subscription plan, your account will be refilled to the selected amount of requests every month. Subscriptions can be changed or canceled at any time.
Chat
We need your consent
Utilizamos cookies (incluidas las de terceros) para recopilar información sobre los visitantes uso de nuestro sitio web. Estas cookies nos ayudan a proporcionarle la mejor experiencia posible en línea y a mejorar nuestros sitios web. La información recogida a través de las cookies también puede ser tratada fuera de la Unión Europea, por ejemplo, en los Estados Unidos. Al hacer clic en el botón "Aceptar todo", usted acepta el uso de cookies. Para retirar su consentimiento en cualquier momento, cambiar su configuración o para obtener más información sobre el uso de cookies, haga clic aquí o en "Configuración de cookies" al final de la página.