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 3,216,768 noms validés par 191 pays. À travers le monde, nous stockons 10,439,658 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 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,126
2.
Albania
6,309
3.
Algeria
24,226
4.
Andorra
760
5.
Angola
8,456
6.
Argentina
10,928
7.
Armenia
1,604
8.
Aruba
134
9.
Australia
9,978
10.
Austria
11,015
11.
Azerbaijan
4,967
12.
Bahamas
532
13.
Bahrain
4,207
14.
Bangladesh
11,096
15.
Barbados
423
16.
Belarus
3,324
17.
Belgium
28,927
18.
Belize
292
19.
Benin
4,670
20.
Bermuda
118
21.
Bhutan
177
22.
Bolivia
1,715
23.
Bosnia and Herzegovina
3,966
24.
Botswana
2,232
25.
Brazil
54,980
26.
Brunei
563
27.
Bulgaria
5,177
28.
Burkina Faso
3,266
29.
Burundi
825
30.
Cambodia
2,199
31.
Cameroon
9,275
32.
Canada
16,196
33.
Cape Verde
1,838
34.
Central African Republic
124
35.
Chad
416
36.
Chile
6,615
37.
China
25,675
38.
Colombia
14,937
39.
Comoros
458
40.
Congo - Brazzaville
4,284
41.
Congo - Kinshasa
1,260
42.
Costa Rica
2,557
43.
Croatia
3,330
44.
Cuba
1,331
45.
Cyprus
4,035
46.
Czech Republic
16,208
47.
Côte d’Ivoire
15,363
48.
Denmark
6,897
49.
Djibouti
1,596
50.
Dominican Republic
4,176
51.
Ecuador
4,694
52.
Egypt
15,454
53.
El Salvador
3,117
54.
Equatorial Guinea
744
55.
Estonia
2,387
56.
Ethiopia
3,624
57.
Faroe Islands
134
58.
Fiji
922
59.
Finland
5,324
60.
France
121,080
61.
French Guiana
886
62.
French Polynesia
352
63.
Gabon
2,886
64.
Gambia
977
65.
Georgia
1,644
66.
Germany
54,765
67.
Ghana
8,856
68.
Gibraltar
418
69.
Greece
13,004
70.
Greenland
176
71.
Grenada
130
72.
Guadeloupe
708
73.
Guam
302
74.
Guatemala
2,419
75.
Guernsey
168
76.
Guinea
1,149
77.
Guinea-Bissau
114
78.
Guyana
336
79.
Haiti
857
80.
Honduras
1,641
81.
Hong Kong SAR China
6,377
82.
Hungary
11,456
83.
Iceland
1,612
84.
India
93,892
85.
Indonesia
62,214
86.
Iran
9,792
87.
Iraq
9,476
88.
Ireland
6,889
89.
Isle of Man
166
90.
Israel
9,438
91.
Italy
68,542
92.
Jamaica
1,650
93.
Japan
23,589
94.
Jersey
458
95.
Jordan
5,650
96.
Kazakhstan
4,450
97.
Kenya
9,663
98.
Kuwait
10,214
99.
Kyrgyzstan
1,497
100.
Laos
775
101.
Latvia
2,184
102.
Lebanon
8,460
103.
Lesotho
580
104.
Liberia
700
105.
Libya
2,583
106.
Liechtenstein
179
107.
Lithuania
2,654
108.
Luxembourg
2,812
109.
Macedonia
3,693
110.
Madagascar
3,303
111.
Malawi
1,145
112.
Malaysia
25,319
113.
Maldives
793
114.
Mali
3,233
115.
Malta
2,321
116.
Martinique
614
117.
Mauritania
979
118.
Mauritius
4,181
119.
Mayotte
240
120.
Mexico
19,403
121.
Micronesia
165
122.
Moldova
2,134
123.
Monaco
563
124.
Mongolia
760
125.
Montenegro
1,060
126.
Morocco
30,312
127.
Mozambique
5,018
128.
Myanmar [Burma]
4,015
129.
Namibia
2,261
130.
Nepal
3,479
131.
Netherlands
35,226
132.
New Caledonia
351
133.
New Zealand
3,735
134.
Nicaragua
1,469
135.
Niger
1,286
136.
Nigeria
50,295
137.
Norway
7,585
138.
Oman
6,978
139.
Pakistan
13,562
140.
Palestinian Territories
2,529
141.
Panama
2,047
142.
Papua New Guinea
816
143.
Paraguay
1,441
144.
Peru
8,303
145.
Philippines
20,341
146.
Poland
14,039
147.
Portugal
24,893
148.
Puerto Rico
2,688
149.
Qatar
5,797
150.
Romania
16,743
151.
Russia
29,415
152.
Rwanda
2,318
153.
Réunion
3,639
154.
Saint Helena
1,281
155.
Saint Lucia
292
156.
San Marino
305
157.
Saudi Arabia
37,545
158.
Senegal
9,925
159.
Serbia
7,306
160.
Seychelles
498
161.
Sierra Leone
735
162.
Singapore
10,648
163.
Slovakia
5,720
164.
Slovenia
3,184
165.
Solomon Islands
128
166.
Somalia
708
167.
South Africa
29,794
168.
South Korea
28,814
169.
Spain
160,271
170.
Sri Lanka
6,962
171.
Sudan
4,286
172.
Suriname
327
173.
Swaziland
472
174.
Sweden
17,278
175.
Switzerland
22,320
176.
Syria
4,047
177.
São Tomé and Príncipe
211
178.
Taiwan
18,515
179.
Tajikistan
681
180.
Tanzania
4,808
181.
Thailand
53,024
182.
Timor-Leste
198
183.
Togo
3,348
184.
Trinidad and Tobago
1,138
185.
Tunisia
14,134
186.
Turkey
63,385
187.
Turkmenistan
536
188.
U.S. Virgin Islands
239
189.
Uganda
6,256
190.
Ukraine
11,295
191.
United Arab Emirates
14,116
192.
United Kingdom
61,245
193.
United States
106,604
194.
Uruguay
1,796
195.
Uzbekistan
2,045
196.
Venezuela
10,020
197.
Vietnam
18,169
198.
Western Sahara
197
199.
Yemen
3,658
200.
Zambia
2,119
201.
Zimbabwe
2,735

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

Download A Sample Project Here:

Documentation:

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

using MicroKnights.Gender_API;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace GenderAPI
{
    class Program
    {
        public static async Task RunTests(GenderApiClient client)
        {
            var responseStats = await client.GetStatistics();
            if( responseStats.IsSuccess ) {
                Console.WriteLine($"IsLimitReached: {responseStats.IsLimitReached}");
                Console.WriteLine($"Remaning requests: {responseStats.RemaningRequests}");

                const string Name = "Frank Nielsen";
                var responseName = await client.GetByNameAndCountry2Alpha(Name, "DK");
                if( responseName.IsSuccess ) {
                    Console.WriteLine($"{Name} is {responseName.GenderType.DisplayName}");
                }
                else {
                    Console.WriteLine($"ERRORS: {responseName.ErrorCode}-{responseName.Exception.Message}");
                }
            }
            else {
                Console.WriteLine($"ERRORS: {responseStats.ErrorCode}-{responseStats.Exception.Message}");
            }
        }

        public static Task UsingServiceProvider(string apiKey){
            // client is thread-safe, and can be used static.
            var serviceProvider = new ServiceCollection()
                .UseGenderAPI(apiKey)
                .BuildServiceProvider();

            return RunTests(serviceProvider.GetRequiredService());
        }

        public static Task PlainConsole(string apiKey){
            // client is thread-safe, and can be used static.
            var client = new GenderApiClient(
                new HttpClient
                {
                    BaseAddress = new Uri("https://gender-api.com")
                }, 
                new GenderApiConfiguration
                {
                    ApiKey = apiKey
                });
            return RunTests(client);
        }

        static async Task Main(string[] args)
        {
            var apiKey = "?";

            await PlainConsole(apiKey);
            await UsingServiceProvider(apiKey);
        }
    }
}

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.

HOW CAN I BUY MORE CREDITS?

You can choose between either a subscription plan or one-time-payment. One-time-payment is recommended, if you want to process a large CSV file or if you prefer to use your credits on a irregular basis. You can charge your account with the required amount of credits at any time. Credits 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 credits every month. Subscriptions can be changed or canceled at any time.
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 ».
Learn more Customize OK !