FORUM AUX QUESTIONS

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

Si vous pouvez indiquer un code pays ou un territoire spécifique dans votre demande, cela améliorera sensiblement notre capacité à déterminer le sexe de la personne concernée. Par exemple : « Andrea » est un prénom masculin en Italie, mais un prénom féminin en Allemagne et un prénom mixte aux États-Unis. Dans un tel cas de figure, nous indiquons une valeur de précision dans le résultat de la demande. Cette valeur comprise entre 0 et 100 indique la certitude avec laquelle nous estimons avoir déterminé le sexe correct de cette personne. Si vous estimez que la valeur est trop faible, vous pouvez toujours demander à votre utilisateur de vous fournir lui-même le sexe correct. Veuillez toutefois noter que dans la plupart des pays, nous sommes à même de déterminer correctement le sexe de la personne dans plus de 94 % des cas.

COMMENT RECUEILLEZ-VOUS LES DONNéES ?

To provide the highest possible accuracy, we combine data from multiple sources. The main sources for new records are publicly available data, governmental data and manual additions/corrections. Based on the source of a new name, the name may have to be verified by a second source before it is added to our list. For example, if we add a name from publicly available data, this name may need a second verification, like a manual confirmation, before it is finally added to our database.

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

Notre base de données contient 6,084,389 noms validés par 191 pays. À travers le monde, nous stockons 41,758,628 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 1 noms dans un pays donné. Veuillez toutefois 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.
Afghanistan
15,606
2.
Albania
37,855
3.
Algeria
186,061
4.
American Samoa
967
5.
Andorra
8,183
6.
Angola
121,331
7.
Anguilla
557
8.
Antigua and Barbuda
2,018
9.
Argentina
81,375
10.
Armenia
10,928
11.
Aruba
1,938
12.
Australia
67,745
13.
Austria
82,653
14.
Azerbaijan
29,878
15.
Bahamas
4,463
16.
Bahrain
32,497
17.
Bangladesh
72,281
18.
Barbados
2,821
19.
Belarus
27,172
20.
Belgium
206,720
21.
Belize
2,631
22.
Benin
41,931
23.
Bermuda
1,300
24.
Bhutan
1,578
25.
Bolivia
15,868
26.
Bosnia and Herzegovina
26,433
27.
Botswana
19,275
28.
Brazil
463,906
29.
British Antarctic Territory
441
30.
British Virgin Islands
646
31.
Brunei
7,179
32.
Bulgaria
29,300
33.
Burkina Faso
26,551
34.
Burundi
5,187
35.
Cambodia
15,413
36.
Cameroon
107,753
37.
Canada
107,756
38.
Cape Verde
16,676
39.
Cayman Islands
1,002
40.
Central African Republic
1,600
41.
Chad
5,002
42.
Chile
57,441
43.
China
224,622
44.
Christmas Island
157
45.
Colombia
118,428
46.
Comoros
5,253
47.
Congo - Brazzaville
46,122
48.
Congo - Kinshasa
11,819
49.
Cook Islands
390
50.
Costa Rica
16,234
51.
Croatia
22,842
52.
Cuba
11,657
53.
Cyprus
27,927
54.
Czech Republic
145,562
55.
Côte d’Ivoire
158,486
56.
Denmark
67,274
57.
Djibouti
15,221
58.
Dominica
1,197
59.
Dominican Republic
41,023
60.
Ecuador
43,818
61.
Egypt
128,387
62.
El Salvador
22,485
63.
Equatorial Guinea
9,835
64.
Eritrea
1,147
65.
Estonia
13,962
66.
Ethiopia
22,061
67.
Falkland Islands
228
68.
Faroe Islands
1,318
69.
Fiji
6,133
70.
Finland
37,044
71.
France
1,040,515
72.
French Guiana
7,178
73.
French Polynesia
3,259
74.
Gabon
30,171
75.
Gambia
7,430
76.
Georgia
11,818
77.
Germany
475,461
78.
Ghana
90,254
79.
Gibraltar
2,592
80.
Greece
107,256
81.
Greenland
1,679
82.
Grenada
1,876
83.
Guadeloupe
5,705
84.
Guam
2,476
85.
Guatemala
18,963
86.
Guernsey
1,292
87.
Guinea
8,925
88.
Guinea-Bissau
2,168
89.
Guyana
2,956
90.
Haiti
9,197
91.
Honduras
12,960
92.
Hong Kong SAR China
57,159
93.
Hungary
100,344
94.
Iceland
13,770
95.
India
576,236
96.
Indonesia
501,174
97.
Iran
63,171
98.
Iraq
73,223
99.
Ireland
55,565
100.
Isle of Man
1,168
101.
Israel
59,358
102.
Italy
651,253
103.
Jamaica
13,030
104.
Japan
169,213
105.
Jersey
2,632
106.
Jordan
42,261
107.
Kazakhstan
29,648
108.
Kenya
77,187
109.
Kiribati
965
110.
Kuwait
80,123
111.
Kyrgyzstan
10,028
112.
Laos
9,001
113.
Latvia
15,007
114.
Lebanon
59,767
115.
Lesotho
5,230
116.
Liberia
6,672
117.
Libya
20,377
118.
Liechtenstein
1,720
119.
Lithuania
18,990
120.
Luxembourg
21,292
121.
Macau SAR China
297
122.
Macedonia
20,651
123.
Madagascar
30,055
124.
Malawi
9,391
125.
Malaysia
235,320
126.
Maldives
9,044
127.
Mali
26,030
128.
Malta
15,566
129.
Marshall Islands
1,035
130.
Martinique
4,823
131.
Mauritania
9,228
132.
Mauritius
28,561
133.
Mayotte
3,041
134.
Mexico
164,574
135.
Micronesia
2,640
136.
Moldova
19,365
137.
Monaco
4,305
138.
Mongolia
5,863
139.
Montenegro
6,915
140.
Montserrat
142
141.
Morocco
245,948
142.
Mozambique
56,535
143.
Myanmar [Burma]
34,089
144.
Namibia
18,841
145.
Nauru
270
146.
Nepal
22,397
147.
Netherlands
239,774
148.
Netherlands Antilles
669
149.
New Caledonia
2,775
150.
New Zealand
23,922
151.
Nicaragua
12,067
152.
Niger
13,498
153.
Nigeria
538,945
154.
Niue
116
155.
Norfolk Island
176
156.
North Korea
830
157.
Northern Mariana Islands
1,361
158.
Norway
65,630
159.
Oman
54,230
160.
Pakistan
91,180
161.
Palau
859
162.
Palestinian Territories
13,770
163.
Panama
15,908
164.
Papua New Guinea
7,596
165.
Paraguay
11,525
166.
Peru
89,655
167.
Philippines
203,777
168.
Poland
173,850
169.
Portugal
234,326
170.
Puerto Rico
20,514
171.
Qatar
44,276
172.
Romania
225,758
173.
Russia
257,235
174.
Rwanda
14,756
175.
Réunion
27,763
176.
Saint Barthélemy
120
177.
Saint Helena
14,679
178.
Saint Kitts and Nevis
899
179.
Saint Lucia
2,910
180.
Saint Martin
1,047
181.
Saint Pierre and Miquelon
188
182.
Saint Vincent and the Grenadines
1,206
183.
Samoa
1,114
184.
San Marino
1,915
185.
Saudi Arabia
284,874
186.
Senegal
83,133
187.
Serbia
51,584
188.
Seychelles
9,652
189.
Sierra Leone
6,111
190.
Singapore
93,648
191.
Slovakia
46,872
192.
Slovenia
24,516
193.
Solomon Islands
1,583
194.
Somalia
7,818
195.
South Africa
216,639
196.
South Korea
225,480
197.
Spain
1,599,498
198.
Sri Lanka
45,521
199.
Sudan
32,666
200.
Suriname
3,308
201.
Swaziland
3,975
202.
Sweden
132,666
203.
Switzerland
169,299
204.
Syria
27,304
205.
São Tomé and Príncipe
3,129
206.
Taiwan
153,318
207.
Tajikistan
4,817
208.
Tanzania
38,179
209.
Thailand
488,052
210.
Timor-Leste
2,874
211.
Togo
29,587
212.
Tonga
1,241
213.
Trinidad and Tobago
7,856
214.
Tunisia
96,422
215.
Turkey
569,155
216.
Turkmenistan
3,808
217.
Turks and Caicos Islands
773
218.
Tuvalu
323
219.
U.S. Virgin Islands
2,177
220.
Uganda
45,005
221.
Ukraine
98,432
222.
United Arab Emirates
95,868
223.
United Kingdom
541,448
224.
United States
671,951
225.
Uruguay
12,861
226.
Uzbekistan
12,632
227.
Vanuatu
1,296
228.
Vatican City
194
229.
Venezuela
91,357
230.
Vietnam
114,475
231.
Wallis and Futuna
189
232.
Western Sahara
2,218
233.
Yemen
32,324
234.
Zambia
17,319
235.
Zimbabwe
21,865
236.
Åland Islands
419

J’AI ENTENDU PARLER DE VOTRE 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 vous permet de personnaliser vos 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, veuillez 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é, vous pouvez télécharger n’importe quel fichier CSV comportant une colonne avec un prénom. Pour un meilleur résultat, vous pouvez également ajouter à votre 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 vous guide tout au long du processus en vous demandant d’indiquer quelle colonne contient quel jeton, y compris le nom ou le pays. Cette fonctionnalité figure dans votre Votre compte. Les enregistrements traités seront facturés comme des demandes. Chaque mois, vous pouvez donc télécharger gratuitement un fichier CSV comprenant jusqu'à 500 entrées. Pour effectuer un téléchargement en bloc CSV, vous devez avoir un compte Gender-API.com.

COMMENT FAUT-IL FORMATER LE FICHIER CSV ?

We support CSV files created on Windows, MacOS, or Linux. In addition, we support files with delimiters like ";", "," or a tab. The enclosure char must be a ". Furthermore, you can upload multi-line CSV files with a maximum of 10,000,000 rows and 301MB. We recommend using a UTF-8 formatted CSV file with a semicolon as the delimiter to achieve the best results possible. Otherwise, the CSV file can contain further, arbitrary rows, which will also be included in the output file. The file must have at least one column with first names only or a column with full names. Click here to download a sample file. Please create a Gender-API.com account to upload a CSV file.

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

Vous pouvez télécharger des fichiers Excel comportant un maximum de 200 000 lignes. Pour les jeux de données plus importants, veuillez utiliser notre téléchargement de fichier CSV. Nous prenons en charge les fichiers .xlsx comportant une feuille. Si vous téléchargez un fichier comprenant plusieurs feuilles, seule la première feuille sera traitée. La première ligne de votre 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

FOURNISSEZ-VOUS DES BIBLIOTHèQUES DE LANGAGES DE PROGRAMMATION ?

En raison de la simplicité de notre API, nous ne fournissons pas de bibliothèques de langages de programmation, à l’exception du plug-in pour jQuery. La plupart des langages de programmation prennent en charge un analyseur json prêt à l’emploi et pour la totalité des autres langages de programmation, il existe déjà une librairie externe que vous pouvez utiliser. Jetez un coup d'œil à nos exemples de codage qui vous permettront de commencer rapidement à utiliser l’API :

Commencez 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 credits
    // left. See https://gender-api.com/en/api-docs/error-codes
    echo 'Exception: ' . $e->getMessage();
}

Link zur Client-Dokumentation auf Github:

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

L'ensemble de la documentation client est accessible ici :

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

Commencez 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

Commencez 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échargez un exemple de projet ici :

Documentation:

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

COMMENT LES DEMANDES SONT-ELLES COMPTABILISéES ?

Chaque compte sera réapprovisionné jusqu'à hauteur de 500 crédits le premier de chaque mois si le nombre de crédits restants sur le compte est inférieur à ce nombre de crédits. La demande ne sera comptabilisée que si un résultat est trouvé. Un crédit sera facturé pour chaque demande. En cas de demande portant sur plusieurs noms, chaque nom sera comptabilisé comme une seule demande.

COMMENT ACHETER DAVANTAGE DE CRéDITS ?

Vous avez le choix entre un plan d’abonnement ou un paiement ponctuel. Nous vous conseillons d’opter pour un paiement ponctuel si vous souhaitez traiter un gros fichier CSV ou si vous préférez utiliser vos demandes de façon irrégulière. Vous pouvez à tout moment approvisionner votre compte du nombre de demandes requis. Les demandes achetées via un paiement ponctuel peuvent être utilisées pendant un an. Si vous préférez opter pour un plan d’abonnement, votre compte sera réapprovisionné chaque mois du nombre de demandes que vous aurez sélectionné. Vous pouvez modifier ou annuler à tout moment votre abonnement.
Chat
Nous utilisons des cookies et des technologies similaires pour reconnaître vos visites répétées et vos préférences, ainsi que pour mesurer l'efficacité des campagnes et analyser le trafic.
Vous pouvez learn plus sur les cookies que nous utilisons ou edit les ici.