All Gender-API.com services are in full compliance with the GDPR.
We provide a Data Processing Agreement (DPA), which enables you to comply with your GDPR obligations.
You can request this agreement here in your account. A sample agreement can be downloaded here.
Also, you can find more information, how we protect your data here.
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.
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.
Oui, nous fournissons à tous nos clients un soutien par courriel. Vous pouvez nous envoyer un courriel à contact gender-api.com. Nous y répondrons dès que possible.
Notre base de données contient 6,084,389 noms validés par 191 pays. À travers le monde, nous stockons 41,758,608 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.
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.
Oui, cela est tout à fait possible. Vous pouvez faire une demande pour un maximum de 100 noms en même temps.
Pour plus d’informations, veuillez consulter nos API documents.
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.
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.
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.
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:
Nous apprécions vraiment votre aide en la matière. Veuillez nous envoyer un courriel à contact gender-api.com et nous corrigerons ce bogue dès que possible.
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
useGenderApi\Clientas GenderApiClient;try{$apiClient=newGenderApiClient('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();// maleecho$lookup->getFirstName();// Thomasecho$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-codesecho'Exception: '.$e->getMessage();}
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.
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.
Ce site web utilise des cookies
Améliorer notre site web, personnaliser le contenu et les publicités, fournir des fonctionnalités de médias sociaux,
et pour analyser notre trafic, nous utilisons des cookies. Nous partageons également des informations sur votre utilisation de notre site avec nos médias sociaux,
es partenaires publicitaires et analytiques, qui peuvent les combiner avec d'autres informations que vous leur avez fournies ou qu'ils ont
Dernière mise à jour de la déclaration des cookies sur 2022-08-10.
Cookies essentiels
Les cookies essentiels vous permettent de naviguer sur le site et d'utiliser ses services et ses fonctionnalités. ans ces cookies
nécessaires
le site ne fonctionnera pas aussi bien que nous le souhaiterions et il est possible que nous ne puissions pas
fournir le site ou certains services ou fonctionnalités.
Cookie
Provider
Type
Description
Durée
PHPSESSID
Gender-API.com
Functional
User information
1 week
euCookie
Gender-API.com
Functional
Stores if cookies were accepted
permanent
euSettings
Gender-API.com
Functional
Cookie policy settings
permanent
darkMode
Gender-API.com
Functional
Dark mode notice
permanent
Cookies facultatifs
Les cookies facultatifs peuvent être désactivés. S'ils sont désactivés, certaines parties du site web peuvent ne pas fonctionner correctement et d'autres fonctions
peuvent
ne pas être disponibles.
Cookie
Provider
Type
Description
Durée
MATOMO_SESSID
Matomo
Analytics
Contains a random generated user id
2 Years
_pk_id
Matomo
Analytics
Used to store a few details about the user such as the unique visitor ID
13 months
_pk_ses, _pk_cvar, _pk_hsr
Matomo
Analytics
Short lived cookies used to temporarily store data for the visit
30 minutes
1P_JAR, CONSENT, NID, OTZ, DV, SOCS, CONSENT, AEC
Google
Marketing
This cookie carries out information about how the end user uses the website and any advertising that the end user may have seen before visiting the said website.
1 month - 6 months
test_cookie
Google DoubleClick
Marketing
Is set as a test to check whether the browser allows cookies to be set. Does not contain any identifiers.
2 years
IDE
Google DoubleClick
Marketing
Used to record and report the user's actions on the website after viewing or clicking on one of the provider's ads
2 years
_gcl_au
Google Adwords
Marketing
Google Ads Conversion Tracking: Contains a random generated user id
90 days
_fbp
Facebook
Marketing
Identifies browsers for the purposes of providing advertising and site analytics services and has a lifespan
of 90 days
90 days
fr
Facebook
Marketing
Used to deliver, measure and improve the relevancy of ads
We use cookies (including third-party cookies) to collect information about visitors'
use of our website. These cookies help us to provide you with the best possible online experience and to constantly
improve our websites. Information collected via cookies may also be processed outside the European Union, for example, in the USA.
By clicking the "Accept All" button, you agree to the use of cookies. To withdraw your consent at any time, change your settings or for more information
about the use of cookies, click here or "Cookie Settings" at the end of the page.
