QUESTIONS FRÉQUEMMENT POSÉES

QUE SE PASSE-T-IL SI UN PRéNOM PEUT êTRE à LA FOIS MASCULIN ET FéMININ ?

Selon la version de ton API ou l'intégration que tu utilises, nos points de terminaison renverront soit une précision soit une valeur de probabilité dans la réponse. Le paramètre de précision indique à quel point nous sommes sûrs que ce nom est soit masculin soit féminin. La valeur est calculée par le nombre d'enregistrements dans notre base de données. Par exemple, si nous avons 100 échantillons d'un nom, 96 sont féminins, et 4 sont masculin, la précision est de 96 % (ou une probabilité de 0,96). Une faible précision indique que ce nom est probablement utilisé par plusieurs genres et ne peut être conjugué à un genre spécifique.

PEUT-IL Y AVOIR DES DIFFéRENCES POUR LE MêME NOM PAR PAYS ?

Alors que le nom Andrea est masculin en Italie, Andrea est un nom féminin en Allemagne et peut même être les deux aux États-Unis. Dans ce cas, nous fournissons une valeur de précision dans le résultat de la requête, comprise entre 0 et 100 (ou une valeur de probabilité comprise entre 0 et 1). Elle t'indique à quel point nous sommes certains d'avoir détecté le bon sexe. Tu peux augmenter de manière significative la qualité des résultats de l'API en fournissant des informations géographiques sur ta requête. Il peut s'agir d' un code pays, la locale du navigateur ou une adresse IP. Tu peux en savoir plus sur la localisation d'une requête dans notre documentation API documentation.

COMMENT RECUEILLES-TU LES DONNéES ?

Pour fournir la plus grande précision possible, nous combinons les données de plusieurs sources. Les principales sources de nouveaux enregistrements sont les données publiques, les données gouvernementales et les ajouts/corrections manuels. En fonction de la source d'un nouveau nom, il se peut que le nom doive être vérifié par une seconde source avant d'être ajouté à notre liste. Par exemple, si nous ajoutons un nom à partir de données accessibles au public, ce nom peut nécessiter une deuxième vérification, comme une confirmation manuelle, avant qu'il soit finalement ajouté à notre base de données. Tu peux trouver une liste des pays supportés ici.

À QUELLE FRéQUENCE METS-TU à JOUR LES ENREGISTREMENTS DE NOMS ?

Nous mettons régulièrement à jour nos données en fonction du pays et des données publiques disponibles. La plupart des pays occidentaux sont mis à jour une fois par an. Par ailleurs, la répartition des noms entre les sexes peut changer au fil des ans. Par exemple, si un nom était utilisé exclusivement par des femmes dans les années 1970, il peut être utilisé majoritairement par des hommes des décennies plus tard. C'est la raison pour laquelle nous utilisons également des données de naissance pour plusieurs pays, comme les États-Unis, afin d'enrichir les résultats. Nos modèles tentent de prendre en compte tous ces facteurs aussi bien que possible. La valeur de précision renvoyée est régulièrement ajustée pour refléter l'usage réel dans la population aussi précise que possible. La valeur est censée fournir une évaluation raisonnable basée sur les dernières décennies et peut exprimer une fluctuation possible. Nous examinons les données des quatre dernières décennies. Si tu exécutes une requête et que tu la répètes un an plus tard, tu peux obtenir un résultat différent parce que notre système peut avoir supprimé d'anciennes données et que de nouvelles données peuvent avoir été ajoutées. Chaque fois que de nouvelles données sont ajoutées, nous effectuons ensuite ce que l'on appelle des tests d'intégration. Au cours de ce processus, notre API est testée par rapport à un ensemble de données préalablement validées pour en garantir la qualité. Cet ensemble de données est continuellement enrichi de noms et de cas de test afin d'obtenir la couverture la plus large possible.

FOURNIS-TU UNE ASSISTANCE DANS LA MISE EN œUVRE DE L’API ?

Oui, nous fournissons une assistance par courrier électronique à tous nos clients. Tu peux nous envoyer un courriel à contact gender-api.com. Nous te répondrons dans les plus brefs délais. Tu peux également trouver des exemples de codage ici. Merci de noter que nous ne pouvons pas t'aider pour tous les langages de programmation et tous les cas d'utilisation. Dans la plupart des cas, tu peux utiliser un client de repos standard dans ton application pour interroger notre API. De nombreuses bibliothèques prennent également en charge l'importation d'un fichier de définition OpenAPI. Tu peux télécharger notre fichier de définition openapi.yml ici.

ET SI NOUS AVONS BESOIN D'UN HAUT NIVEAU DE PRéCISION ?

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.

COMBIEN DE NOMS SONT STOCKéS DANS TA BASE DE DONNéES ?

Notre base de données contient 6,084,389 noms validés par 191 pays. À travers le monde, nous stockons 6,195,008 noms uniques. Nous analysons en moyenne environ 10 000 000 jeux de données par mois afin d’améliorer la qualité de nos résultats.

QUELS SONT LES PAYS PRIS EN CHARGE ?

L’API prend entièrement en charge 191 pays. Une prise en charge complète signifie que nous avons recueilli au moins noms dans un pays donné. Toutefois merci de noter que dans la plupart des pays, notre ensemble de données est beaucoup plus important. Nous vous invitons à consulter le tableau ci-après afin d’en savoir davantage sur le nombre de noms que nous prenons en charge dans tel ou tel pays. Et n’oubliez pas que si nous n’assurons pas nous-mêmes une prise en charge appropriée pour un pays spécifique, vous pouvez toujours analyser les noms en question dans l’ensemble des données dans son intégralité afin d’obtenir un résultat adéquat.
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.

J’AI ENTENDU PARLER DE TON API POUR ADRESSES éLECTRONIQUES. DE QUOI S’AGIT-IL EXACTEMENT ?

Notre API pour adresses électroniques peut extraire des noms à partir d’adresses électroniques et déterminer ainsi le sexe de la personne utilisant cette adresse électronique. Cela te permet de personnaliser tes courriels en employant une formule de salutation appropriée. Ainsi, par exemple, pour l’adresse électronique "marie.johnson@gmail.com", l’API extraira le nom "Marie" et déterminera le sexe correct de la personne, lequel est "féminin". Pour plus d’informations, merci de consulter nos documents API.

JE DISPOSE D’UNE TRèS GRANDE QUANTITé DE DONNéES. PUIS-JE FAIRE UN TéLéCHARGEMENT EN BLOC D’UN FICHIER CSV ?

En tant qu’utilisateur enregistré, tu peux télécharger n’importe quel fichier CSV comportant une colonne avec un prénom. Pour un meilleur résultat, tu peux également ajouter à ton jeu de données une colonne avec un pays. Il n’est pas nécessaire de nommer les colonnes de manière spécifique mais notre assistant te guide tout au long du processus en te demandant d’indiquer quelle colonne contient quel jeton, y compris le nom ou le pays. Cette fonctionnalité figure dans v ton compte. Les enregistrements traités seront facturés comme des demandes. Chaque mois, tu peux donc télécharger gratuitement un fichier CSV comprenant jusqu'à 100 entrées. Pour effectuer un téléchargement en bloc CSV, tu dois avoir un compte Gender-API.com.

COMMENT FAUT-IL FORMATER LE FICHIER CSV ?

Nous prenons en charge les fichiers CSV créés dans Windows, Mac OSX ou Linux. Nous prenons également en charge les fichiers avec des séparateurs tels que ";", "," ou une tabulation. Le caractère d’encadrement doit être un ". Tu peux également télécharger des fichiers CSV multilignes comportant un maximum of 10 000 000 lignes et 301 MB. Afin d’obtenir les meilleurs résultats possibles, nous te recommandons toutefois d’utiliser un fichier CSV encodé en UTF-8 avec un point-virgule comme séparateur. Sinon, le fichier CSV peut contenir des lignes arbitraires supplémentaires qui doivent également figurer dans le fichier de sortie. Le fichier doit comporter au moins une colonne avec uniquement des noms complets. Clique ici ici pour télécharger un exemple de fichier. Merci de créer un compte Gender-API.com pour télécharger un fichier CSV.

PUIS-JE TéLéCHARGER UN FICHIER EXCEL ?

Tu peux télécharger des fichiers Excel comportant un maximum de 200 000 lignes. Pour les jeux de données plus importants, merci d' utiliser notre téléchargement de fichier CSV. Nous prenons en charge les fichiers .xlsx comportant une feuille. Si tu télécharges un fichier comprenant plusieurs feuilles, seule la première feuille sera traitée. La première ligne de ta feuille doit contenir la colonne avec les noms. Le fichier doit comprendre au moins une colonne avec des prénoms ; la colonne avec le pays est facultative. Télécharger un exemple de fichier ici. Exemple:
Exemple Excel

FOURNIS-TU DES BIBLIOTHèQUES DE LANGAGES DE PROGRAMMATION ?

En raison de la simplicité de notre API, nous ne fournissons pas de librairie pour un quelconque langage de programmation, à l'exception du plugin jQuery. La plupart des langages supportent un analyseur json prêt à l'emploi et pour presque tous les autres langages, il existe déjà une bibliothèque externe que tu peux utiliser. Jètes un coup d'œil à nos exemples de codage pour commencer à utiliser l'API :

Commence par installer notre bibliothèque avec Composer :

$ 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();
}

L'ensemble de la documentation client est accessible ici :

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

Commence par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

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

Commence par installer notre bibliothèque avec npm :

L'ensemble de la documentation client est accessible ici :

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

Télécharge un exemple de projet ici :

Documentation:

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

COMMENT LES DEMANDES SONT-ELLES COMPTABILISéES ?

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.

Où PUIS-JE TROUVER ET GéRER MES CLéS 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. Capture d'écran de la boîte de la clé 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". Gestion de plusieurs clés 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.

PUIS-JE PARTAGER MON COMPTE AVEC PLUSIEURS PERSONNES ?

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.

PUIS-JE PROTéGER MON COMPTE EN ACTIVANT LA VéRIFICATION EN DEUX éTAPES ?

Tu peux protéger ton compte en activant la vérification en deux étapes. Pour activer cette mesure de sécurité supplémentaire, connecte-toi à ton compte et, dans le menu "Comptes", clique sur "Paramètres" => "Modifier le mot de passe / 2FA". Assures-toi qu'une application d'authentification est installée sur ton téléphone. Nous vous recommandons d'utiliser une application comme Authy (App Store, Play Store) ou Google Authenticator (App Store, Play Store). Clique ensuite sur le bouton "Activer maintenant" et suis les instructions à l'écran. Tu peux ajouter plusieurs appareils ici pour t'assurer, par exemple, que tu as toujours accès à ton compte après avoir perdu un appareil. Une fois la fonction activée, tu devras saisir le code généré par l'application d'authentification de ton téléphone pour te connecter avec succès.

PUIS-JE UTILISER DES APPLICATIONS TIERCES LORSQUE LA VéRIFICATION EN DEUX éTAPES EST ACTIVéE ?

Certaines intégrations ou applications tierces fonctionnent parfaitement avec la vérification en deux étapes activée. D'autres peuvent demander à se connecter sans vérification en deux étapes. Si tu rencontres des problèmes pour te connecter à une application avec tes informations d'identification de Gender-API.com, connecte-toi directement à ton compte sur Gender-API et cliques sur "Réglages" => "Changer le mot de passe / 2FA" dans le menu du compte. Clique ensuite sur l'onglet "Vérification en deux étapes" onglet et définir "Accès aux applications tierces" sur "Non restreint". Merci de noter que tu ne peux modifier ce paramètre que si la vérification en deux étapes est activée.

QUELLE EST LA DIFFéRENCE ENTRE UN COMPTE PAYANT ET UN COMPTE GRATUIT ?

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.

QUELLE EST LA DIFFéRENCE ENTRE UN ABONNEMENT ET UN PAIEMENT UNIQUE ?

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. Types d'achat 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.

I NEED A CERTIFICATE OF RESIDENCE. CAN YOU ISSUE SUCH A CERTIFICATE?

If you need a certificate of residence from our company, please contact our support regarding your request. The certificate has to be individually requested for every company. Include in your request the full address of your company, your country of residence, and, if available, your tax number. The certificate of residence needs to be signed through our revenue office. It usually takes 2-3 weeks to receive the signed form, which we can then provide as a digital scan. Screenshot Certificate Of Resicence

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
Nous utilisons des cookies (y compris des cookies tiers) pour collecter des informations sur l'utilisation par les visiteurs de notre site web. Ces cookies nous permettent de te fournir la meilleure expérience en ligne possible et à améliorer constamment nos sites web. Les informations recueillies par le biais des cookies peuvent également être traitées en dehors de l'Union européenne, par exemple, aux États-Unis. En cliquant sur le bouton "Accepter tout", vous acceptez l'utilisation de cookies. Pour retirer ton consentement à tout moment, modifier tes paramètres ou pour obtenir plus d'informations sur l'utilisation des cookies, clique sur ici ou sur "Paramètres des Cookies" à la fin de la page.