API-documentatie Unified API v2.0

API v1.0

We bieden ook een andere API-versie aan met eindpunten die gemakkelijker te integreren zijn. Als je een beginner bent in het implementeren van API's, kun je overschakelen naar ons endpoint v1.0.

Bekijk API v1.0

OpenAPI

Bekijk onze API-documentatie in Swagger

Postman

Importeer onze API-definitie in Postman

Zoek op voornaam

Zoeken op volledige naam

Zoek op e-mailadres

Haal het land van oorsprong op

Bekijk statistieken

Foutcodes

endpoint-not-found

Status	endpoint-not-found
HTTP Status Code	404
Description	API endpoint not found

limit-exceeded

Status	limit-exceeded
HTTP Status Code	401
Description	Limit exceeded. Thank you for using our service. Please consider to buy more requests.

parameter-first-name-invalid

Status	parameter-first-name-invalid
HTTP Status Code	400
Description	The "first_name" parameter is invalid. The parameter can only be a string with a length from 1 to 50 chars.

parameter-full-name-invalid

Status	parameter-full-name-invalid
HTTP Status Code	400
Description	The "full_name" parameter is invalid. The parameter can only be a string with a length from 3 to 100 chars.

parameter-email-invalid

Status	parameter-email-invalid
HTTP Status Code	400
Description	The "email" parameter is invalid. The parameter can only be a string with a length from 3 to 100 chars and must be a valid email address.

key-parameter-missing

Status	key-parameter-missing
HTTP Status Code	400
Description	The "key" parameter is not set. Please create an account to fetch an API key.

invalid-key

Status	invalid-key
HTTP Status Code	400
Description	Invalid API key. You can find your personal API key in your account.

invalid-country-code

Status	invalid-country-code
HTTP Status Code	400
Description	The given country code is not valid. You can find a list of valid country codes in our API docs.

invalid-ip-address

Status	invalid-ip-address
HTTP Status Code	400
Description	The given ip address is not valid. Please provide either a valid IPv4 or an IPv6 address.

generic-error

Status	generic-error
HTTP Status Code	400
Description

invalid-json

Status	invalid-json
HTTP Status Code	400
Description

invalid-locale

Status	invalid-locale
HTTP Status Code	400
Description	The given locale is not valid. You can find a list of valid country codes in our API docs.

invalid-id

Status	invalid-id
HTTP Status Code	400
Description	The given id is not valid. An id can be either an integer or a string with 50 chars at max.

mandatory-parameter-missing

Status	mandatory-parameter-missing
HTTP Status Code	400
Description	Mandatory parameter missing. Either first_name, full_name or email must be set.

content-type-missing

Status	content-type-missing
HTTP Status Code	400
Description	Content-Type missing. Please add a "Content-Type: application/json" to your API call.

missing-json

Status	missing-json
HTTP Status Code	400
Description	We weren't able to find a json body in your API call. Please make sure the body is sent with a POST request to our API endpoint.

too-many-queries

Status	too-many-queries
HTTP Status Code	400
Description	Too many queries in a single API call.

too-many-queries-api-key

Status	too-many-queries-api-key
HTTP Status Code	400
Description	Too many queries in a single API call. Your API key is limited to 3 lookups per request.

authorization-header-missing

Status	authorization-header-missing
HTTP Status Code	400
Description	Your query misses the "Authorization" header with the bearer token.

invalid-auth-token

Status	invalid-auth-token
HTTP Status Code	400
Description	Invalid authentication token provided. Please log in to your account to find a list of valid tokens or to create a new one.

email-invalid

Status	email-invalid
HTTP Status Code	400
Description	Invalid or empty email address given.

password-invalid

Status	password-invalid
HTTP Status Code	400
Description	Invalid credentials. Login failed. Please also check your account that third-party app access is not restricted.: https://gender-api.com/de/account/password

label-invalid

Status	label-invalid
HTTP Status Code	400
Description	Invalid label given. A label must be a string between 2 and 30 chars.

email-account-not-found

Status	email-account-not-found
HTTP Status Code	400
Description	No Gender-API.com account found. Please create a free account first, to sign-in with Google or try to login with an existing username or password.

invalid-list-of-names

Status	invalid-list-of-names
HTTP Status Code	400
Description	Invalid list of names. Expected array of strings.

Dit product bevat GeoLite2-gegevens die zijn gemaakt door MaxMind, beschikbaar op http://www.maxmind.com.

Deze website maakt gebruik van cookies

Om onze website te verbeteren, inhoud en advertenties te personaliseren, sociale media-functies te bieden en ons verkeer te analyseren, gebruiken wij cookies. We delen ook informatie over uw gebruik van onze site met onze sociale media-, advertentie- en analysepartners, die deze kunnen combineren met andere informatie die u aan hen hebt verstrekt of die zij hebben verzameld tijdens het gebruik van hun diensten. Door onze site te blijven gebruiken, stemt u in met het gebruik van cookies op deze site.

Cookieverklaring laatst bijgewerkt op 2022-08-10.

Essentiële cookies

Essentiële cookies stellen je in staat om de site te navigeren en de services en functies te gebruiken. Zonder deze noodzakelijke cookies zal de site niet zo soepel werken als we zouden willen en zouden we mogelijk niet in staat zijn om de site of bepaalde services of functies te bieden.

Cookie	Leverancier	Type	Beschrijving	Duur
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

Optionele cookies

Optionele cookies kunnen uitgeschakeld worden. Als ze uitgeschakeld zijn, kunnen sommige delen van de website mogelijk niet goed functioneren en andere functies zijn wellicht niet beschikbaar.

Cookie	Leverancier	Type	Beschrijving	Duur
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	90 days
_twclid	Twitter	Marketing	Identifies browsers for the purposes of providing advertising and site analytics service	30 days
auth_token	Twitter	Functional	Twitter login cookie	5 years
personalization_id	Twitter	Marketing	Identifies browsers for the purposes of providing advertising and site analytics service	2 years

Matomo Analytics plugin to collect anonymous usage statistics. The statistics help us, to optimize our webpage Privacybeleid Dit privacybeleid beschrijft hoe wij persoonlijke informatie verzamelen, gebruiken en delen die we van jou ontvangen wanneer je onze diensten en website gebruikt. Wij streven ernaar jouw privacy te beschermen en zijn transparant over de manier waarop wij jouw persoonlijke gegevens verwerken. Welke informatie verzamelen we? Wij verzamelen informatie van jou wanneer je onze website bezoekt, een account registreert, een bestelling plaatst, enquêtes invult of op andere wijze communiceert met onze diensten en website. De persoonlijke informatie die we verzamelen kan onder meer naam, adres, e-mailadres, telefoonnummer en betalingsgegevens omvatten. Hoe gebruiken we jouw informatie? Wij kunnen jouw persoonlijke informatie gebruiken om onze diensten te leveren en te verbeteren, om contact met jou op te nemen over jouw bestelling, om enquêtes uit te voeren en om relevante marketingcommunicatie te verzenden. Hoe delen we jouw informatie? Wij verkopen jouw persoonlijke informatie niet aan derden. Wij kunnen jouw informatie delen met serviceproviders die wij inhuren om ons te helpen bij het uitvoeren van onze diensten. Deze serviceproviders hebben beperkte toegang tot jouw persoonlijke informatie om hun taken uit te voeren en zijn verplicht deze te beschermen. Hoe beschermen we jouw informatie? Wij nemen beveiligingsmaatregelen om jouw persoonlijke informatie te beschermen tegen ongeautoriseerde toegang, wijziging of openbaarmaking. Wij streven er voortdurend naar onze veiligheidsmaatregelen te verbeteren. Jouw keuzes Je kunt ervoor kiezen om geen marketingcommunicatie van ons te ontvangen door contact met ons op te nemen. Je hebt ook het recht om jouw persoonlijke gegevens te laten verwijderen of bij te werken. Andere informatie Onze website kan links bevatten naar andere websites die niet onder dit privacybeleid vallen. Wij zijn niet verantwoordelijk voor de privacypraktijken van deze websites. Contact met ons opnemen Als je vragen of opmerkingen hebt over ons privacybeleid, kun je contact met ons opnemen via [contactgegevens]: https://gender-api.com/en/privacy-policy

Google Ads Conversion Tracking Analytics plugin to track marketing activities. The statistics help us, to optimize our webpage Privacybeleid Dit privacybeleid beschrijft hoe wij persoonlijke informatie verzamelen, gebruiken en delen die we van jou ontvangen wanneer je onze diensten en website gebruikt. Wij streven ernaar jouw privacy te beschermen en zijn transparant over de manier waarop wij jouw persoonlijke gegevens verwerken. Welke informatie verzamelen we? Wij verzamelen informatie van jou wanneer je onze website bezoekt, een account registreert, een bestelling plaatst, enquêtes invult of op andere wijze communiceert met onze diensten en website. De persoonlijke informatie die we verzamelen kan onder meer naam, adres, e-mailadres, telefoonnummer en betalingsgegevens omvatten. Hoe gebruiken we jouw informatie? Wij kunnen jouw persoonlijke informatie gebruiken om onze diensten te leveren en te verbeteren, om contact met jou op te nemen over jouw bestelling, om enquêtes uit te voeren en om relevante marketingcommunicatie te verzenden. Hoe delen we jouw informatie? Wij verkopen jouw persoonlijke informatie niet aan derden. Wij kunnen jouw informatie delen met serviceproviders die wij inhuren om ons te helpen bij het uitvoeren van onze diensten. Deze serviceproviders hebben beperkte toegang tot jouw persoonlijke informatie om hun taken uit te voeren en zijn verplicht deze te beschermen. Hoe beschermen we jouw informatie? Wij nemen beveiligingsmaatregelen om jouw persoonlijke informatie te beschermen tegen ongeautoriseerde toegang, wijziging of openbaarmaking. Wij streven er voortdurend naar onze veiligheidsmaatregelen te verbeteren. Jouw keuzes Je kunt ervoor kiezen om geen marketingcommunicatie van ons te ontvangen door contact met ons op te nemen. Je hebt ook het recht om jouw persoonlijke gegevens te laten verwijderen of bij te werken. Andere informatie Onze website kan links bevatten naar andere websites die niet onder dit privacybeleid vallen. Wij zijn niet verantwoordelijk voor de privacypraktijken van deze websites. Contact met ons opnemen Als je vragen of opmerkingen hebt over ons privacybeleid, kun je contact met ons opnemen via [contactgegevens]: https://policies.google.com/privacy

Facebook Tracking Pixel Analytics plugin to collect conversions usage statistics. The data helps us to optimize our ad campaigns Privacybeleid Dit privacybeleid beschrijft hoe wij persoonlijke informatie verzamelen, gebruiken en delen die we van jou ontvangen wanneer je onze diensten en website gebruikt. Wij streven ernaar jouw privacy te beschermen en zijn transparant over de manier waarop wij jouw persoonlijke gegevens verwerken. Welke informatie verzamelen we? Wij verzamelen informatie van jou wanneer je onze website bezoekt, een account registreert, een bestelling plaatst, enquêtes invult of op andere wijze communiceert met onze diensten en website. De persoonlijke informatie die we verzamelen kan onder meer naam, adres, e-mailadres, telefoonnummer en betalingsgegevens omvatten. Hoe gebruiken we jouw informatie? Wij kunnen jouw persoonlijke informatie gebruiken om onze diensten te leveren en te verbeteren, om contact met jou op te nemen over jouw bestelling, om enquêtes uit te voeren en om relevante marketingcommunicatie te verzenden. Hoe delen we jouw informatie? Wij verkopen jouw persoonlijke informatie niet aan derden. Wij kunnen jouw informatie delen met serviceproviders die wij inhuren om ons te helpen bij het uitvoeren van onze diensten. Deze serviceproviders hebben beperkte toegang tot jouw persoonlijke informatie om hun taken uit te voeren en zijn verplicht deze te beschermen. Hoe beschermen we jouw informatie? Wij nemen beveiligingsmaatregelen om jouw persoonlijke informatie te beschermen tegen ongeautoriseerde toegang, wijziging of openbaarmaking. Wij streven er voortdurend naar onze veiligheidsmaatregelen te verbeteren. Jouw keuzes Je kunt ervoor kiezen om geen marketingcommunicatie van ons te ontvangen door contact met ons op te nemen. Je hebt ook het recht om jouw persoonlijke gegevens te laten verwijderen of bij te werken. Andere informatie Onze website kan links bevatten naar andere websites die niet onder dit privacybeleid vallen. Wij zijn niet verantwoordelijk voor de privacypraktijken van deze websites. Contact met ons opnemen Als je vragen of opmerkingen hebt over ons privacybeleid, kun je contact met ons opnemen via [contactgegevens]: https://www.facebook.com/policies/cookies/

Twitter Conversion Tracking Pixel Analytics plugin to collect conversions usage statistics. The data helps us to optimize our ad campaigns Privacybeleid Dit privacybeleid beschrijft hoe wij persoonlijke informatie verzamelen, gebruiken en delen die we van jou ontvangen wanneer je onze diensten en website gebruikt. Wij streven ernaar jouw privacy te beschermen en zijn transparant over de manier waarop wij jouw persoonlijke gegevens verwerken. Welke informatie verzamelen we? Wij verzamelen informatie van jou wanneer je onze website bezoekt, een account registreert, een bestelling plaatst, enquêtes invult of op andere wijze communiceert met onze diensten en website. De persoonlijke informatie die we verzamelen kan onder meer naam, adres, e-mailadres, telefoonnummer en betalingsgegevens omvatten. Hoe gebruiken we jouw informatie? Wij kunnen jouw persoonlijke informatie gebruiken om onze diensten te leveren en te verbeteren, om contact met jou op te nemen over jouw bestelling, om enquêtes uit te voeren en om relevante marketingcommunicatie te verzenden. Hoe delen we jouw informatie? Wij verkopen jouw persoonlijke informatie niet aan derden. Wij kunnen jouw informatie delen met serviceproviders die wij inhuren om ons te helpen bij het uitvoeren van onze diensten. Deze serviceproviders hebben beperkte toegang tot jouw persoonlijke informatie om hun taken uit te voeren en zijn verplicht deze te beschermen. Hoe beschermen we jouw informatie? Wij nemen beveiligingsmaatregelen om jouw persoonlijke informatie te beschermen tegen ongeautoriseerde toegang, wijziging of openbaarmaking. Wij streven er voortdurend naar onze veiligheidsmaatregelen te verbeteren. Jouw keuzes Je kunt ervoor kiezen om geen marketingcommunicatie van ons te ontvangen door contact met ons op te nemen. Je hebt ook het recht om jouw persoonlijke gegevens te laten verwijderen of bij te werken. Andere informatie Onze website kan links bevatten naar andere websites die niet onder dit privacybeleid vallen. Wij zijn niet verantwoordelijk voor de privacypraktijken van deze websites. Contact met ons opnemen Als je vragen of opmerkingen hebt over ons privacybeleid, kun je contact met ons opnemen via [contactgegevens]: https://www.facebook.com/policies/cookies/

Instellingen opslaan

App-integraties

API-marktplaatsen