FORUM AUX QUESTIONS

QUE PRéVOIT LE RèGLEMENT GéNéRAL RELATIF à LA PROTECTION DES DONNéES (« RGPD ») ?

Le nouveau règlement général relatif à la protection des données (« RGPD ») entrera en vigueur le 25 mai 2018. Nous pouvons vous garantir qu’à cette date, tous les services Gender-API.com seront parfaitement conformes au RGPD. Nous mettons à votre disposition un accord sur la protection des données qui vous permet de remplir vos obligations au titre du RGPD. Vous pouvez demander cet accord ici sur votre compte. Vous avez également la possibilité de télécharger un exemple d’accord ici.

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 ?

Afin de fournir la plus grande précision possible, nous combinons des données prélevées de sources différentes. Nous utilisons des données issues de sources gouvernementales accessibles au public et les associons aux données que nous recueillons sur les réseaux sociaux. Cette approche nous permet d’obtenir les meilleures correspondances possibles. Chaque nom doit être vérifié par différentes sources afin d’être ajouté à notre liste.

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

Notre base de données contient 1,877,786 noms validés par 178 pays. À travers le monde, nous stockons 811,429 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 178 pays. Une prise en charge complète signifie que nous avons recueilli au moins 300 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
2,163
2.
Albania
6,429
3.
Algeria
24,724
4.
Andorra
768
5.
Angola
8,546
6.
Argentina
11,051
7.
Armenia
1,627
8.
Aruba
139
9.
Australia
10,251
10.
Austria
11,300
11.
Azerbaijan
5,094
12.
Bahamas
545
13.
Bahrain
4,388
14.
Bangladesh
11,308
15.
Barbados
435
16.
Belarus
3,377
17.
Belgium
29,455
18.
Belize
302
19.
Benin
4,763
20.
Bermuda
119
21.
Bhutan
179
22.
Bolivia
1,728
23.
Bosnia and Herzegovina
4,039
24.
Botswana
2,330
25.
Brazil
55,485
26.
Brunei
580
27.
Bulgaria
5,228
28.
Burkina Faso
3,319
29.
Burundi
844
30.
Cambodia
2,289
31.
Cameroon
9,458
32.
Canada
16,196
33.
Cape Verde
1,855
34.
Central African Republic
128
35.
Chad
423
36.
Chile
6,677
37.
China
26,660
38.
Colombia
15,060
39.
Comoros
459
40.
Congo - Brazzaville
4,400
41.
Congo - Kinshasa
1,288
42.
Costa Rica
2,582
43.
Croatia
3,395
44.
Cuba
1,343
45.
Cyprus
4,144
46.
Czech Republic
16,529
47.
Côte d’Ivoire
15,617
48.
Denmark
7,043
49.
Djibouti
1,624
50.
Dominican Republic
4,221
51.
Ecuador
4,745
52.
Egypt
15,926
53.
El Salvador
3,156
54.
Equatorial Guinea
754
55.
Estonia
2,411
56.
Ethiopia
3,680
57.
Faroe Islands
134
58.
Fiji
943
59.
Finland
5,424
60.
France
122,717
61.
French Guiana
898
62.
French Polynesia
353
63.
Gabon
2,955
64.
Gambia
1,015
65.
Georgia
1,670
66.
Germany
54,475
67.
Ghana
9,225
68.
Gibraltar
422
69.
Greece
13,358
70.
Greenland
179
71.
Grenada
133
72.
Guadeloupe
724
73.
Guam
314
74.
Guatemala
2,445
75.
Guernsey
170
76.
Guinea
1,160
77.
Guinea-Bissau
115
78.
Guyana
345
79.
Haiti
872
80.
Honduras
1,658
81.
Hong Kong SAR China
6,698
82.
Hungary
11,663
83.
Iceland
1,633
84.
India
95,051
85.
Indonesia
63,041
86.
Iran
10,020
87.
Iraq
9,648
88.
Ireland
7,100
89.
Isle of Man
169
90.
Israel
9,606
91.
Italy
69,854
92.
Jamaica
1,690
93.
Japan
24,067
94.
Jersey
468
95.
Jordan
5,842
96.
Kazakhstan
4,515
97.
Kenya
9,899
98.
Kuwait
10,638
99.
Kyrgyzstan
1,511
100.
Laos
804
101.
Latvia
2,203
102.
Lebanon
8,752
103.
Lesotho
594
104.
Liberia
735
105.
Libya
2,658
106.
Liechtenstein
183
107.
Lithuania
2,680
108.
Luxembourg
2,860
109.
Macedonia
3,784
110.
Madagascar
3,347
111.
Malawi
1,200
112.
Malaysia
25,983
113.
Maldives
812
114.
Mali
3,282
115.
Malta
2,353
116.
Martinique
626
117.
Mauritania
996
118.
Mauritius
4,266
119.
Mayotte
248
120.
Mexico
19,691
121.
Micronesia
167
122.
Moldova
2,164
123.
Monaco
571
124.
Mongolia
769
125.
Montenegro
1,068
126.
Morocco
30,875
127.
Mozambique
5,093
128.
Myanmar [Burma]
4,252
129.
Namibia
2,325
130.
Nepal
3,549
131.
Netherlands
35,917
132.
New Caledonia
352
133.
New Zealand
3,721
134.
Nicaragua
1,478
135.
Niger
1,303
136.
Nigeria
51,405
137.
Norway
7,732
138.
Oman
7,259
139.
Pakistan
13,957
140.
Palestinian Territories
2,552
141.
Panama
2,069
142.
Papua New Guinea
830
143.
Paraguay
1,452
144.
Peru
8,390
145.
Philippines
20,712
146.
Poland
14,368
147.
Portugal
25,293
148.
Puerto Rico
2,717
149.
Qatar
5,984
150.
Romania
16,998
151.
Russia
30,111
152.
Rwanda
2,361
153.
Réunion
3,711
154.
Saint Helena
1,340
155.
Saint Lucia
293
156.
San Marino
307
157.
Saudi Arabia
38,373
158.
Senegal
10,112
159.
Serbia
7,438
160.
Seychelles
507
161.
Sierra Leone
753
162.
Singapore
11,001
163.
Slovakia
5,813
164.
Slovenia
3,241
165.
Solomon Islands
131
166.
Somalia
721
167.
South Africa
30,545
168.
South Korea
29,708
169.
Spain
161,432
170.
Sri Lanka
7,035
171.
Sudan
4,365
172.
Suriname
332
173.
Swaziland
493
174.
Sweden
17,666
175.
Switzerland
22,895
176.
Syria
4,168
177.
São Tomé and Príncipe
212
178.
Taiwan
19,099
179.
Tajikistan
685
180.
Tanzania
4,953
181.
Thailand
54,192
182.
Timor-Leste
204
183.
Togo
3,442
184.
Trinidad and Tobago
1,163
185.
Tunisia
14,407
186.
Turkey
64,496
187.
Turkmenistan
542
188.
U.S. Virgin Islands
250
189.
Uganda
6,416
190.
Ukraine
11,584
191.
United Arab Emirates
14,519
192.
United Kingdom
61,246
193.
United States
97,486
194.
Uruguay
1,810
195.
Uzbekistan
2,070
196.
Venezuela
10,086
197.
Vietnam
18,575
198.
Western Sahara
197
199.
Yemen
3,744
200.
Zambia
2,200
201.
Zimbabwe
2,894

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 ?

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 ". Vous pouvez également télécharger des fichiers CSV multilignes comportant un maximum of 10 000 000 lignes et 200 Mo. Afin d’obtenir les meilleurs résultats possibles, nous vous 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 prénoms. Cliquez ici ici pour télécharger un exemple de fichier. Veuillez créer un compte Gender-API.com pour télécharger un fichier CSV.

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 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

function getGender($firstname) {
    $myKey = 'insert your server key here';
    $data = json_decode(file_get_contents(
        'https://gender-api.com/get?key=' . $myKey .
        '&name=' . urlencode($firstname)));
    return $data->gender;
}

echo getGender('markus'); //Output: male

Commencez par installer notre bibliothèque avec npm :

$ npm i gender-api.com-client --save
import {Client as GenderApiClient, ResultSingleName} from "gender-api.com-client";

const genderApiClient = new GenderApiClient("your API key");

try {
    genderApiClient.getByFirstName('theresa', (response: ResultSingleName) => {
      console.log(response.gender); //female
      console.log(response.accuracy); //98
    });
  
    genderApiClient.getByFirstNameAndCountry('john', 'US', (response: ResultSingleName) => {
      console.log(response.gender); //male
      console.log(response.accuracy); //99
    });
}
catch(e) {
  console.log('Error:', e);
}

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 :

$ npm i gender-api.com-client --save
try {
    var GenderApi = require('gender-api.com-client');

    var genderApiClient = new GenderApi.Client('your api key');

    genderApiClient.getByFirstName('theresa', function (response) {
        console.log(response.gender); //female
        console.log(response.accuracy); //98
    });

    genderApiClient.getByFirstNameAndCountry('john', 'US', function (response) {
        console.log(response.gender); //male
        console.log(response.accuracy); //99
    });

}
catch(e) {
    console.log('Error:', e);
}

L'ensemble de la documentation client est accessible ici :

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

Python 3.*
import json

from urllib.request import urlopen

myKey = "insert your server key here"
url = "https://gender-api.com/get?key=" + myKey + "&name=kevin"
response = urlopen(url)
decoded = response.read().decode('utf-8')
data = json.loads(decoded)
print( "Gender: " + data["gender"]); #Gender: male

Python 2.*
import json
import urllib2

myKey = "insert your servery key here"
data = json.load(urllib2.urlopen("https://gender-api.com/get?key=" + myKey + "&name=markus"))
print "Gender: " + data["gender"]; #Gender: male
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import com.google.gson.Gson;
import com.google.gson.JsonObject;

public class Main {

  public static void main(String[] args) {

  try {

    String myKey = "insert your server key here";
    URL url = new URL("https://gender-api.com/get?key=" + myKey + "&name=markus");
    HttpURLConnection conn = (HttpURLConnection) url.openConnection();

    if (conn.getResponseCode() != 200) {
      throw new RuntimeException("Error: " + conn.getResponseCode());
    }

    InputStreamReader input = new InputStreamReader(conn.getInputStream());
    BufferedReader reader = new BufferedReader(input);

    Gson gson = new Gson();
    JsonObject json = gson.fromJson(reader, JsonObject.class);
    String gender = json.get("gender").getAsString();
    System.out.println("Gender: " + gender); // Gender: male
    conn.disconnect();

    } catch (IOException e) {
      e.printStackTrace();
    }
  }
}

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 DEMANDES ?

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.

Nous utilisons des « cookies » afin de vous garantir la meilleure expérience possible sur notre site Web. Si vous continuez à utiliser ce site, nous supposerons que vous nous autorisez à utiliser ces « cookies ».
OK !