Question 1

Wat gebeurt er als een naam zowel door mannen als vrouwen wordt gebruikt?

Accepted Answer

Afhankelijk van je API-versie of de integratie die je gebruikt, retourneren onze endpoints een nauwkeurigheids- of een waarschijnlijkheidswaarde in de respons. De parameter accuracy geeft aan hoe zeker we zijn dat deze naam mannelijk of vrouwelijk is. De waarde wordt berekend aan de hand van het aantal records in onze database. Als we bijvoorbeeld 100 steekproeven van een naam hebben, waarvan 96 vrouwelijk en 4 mannelijk, dan is de nauwkeurigheid 96% (of een waarschijnlijkheid van .96). Een lage nauwkeurigheid geeft aan dat deze naam waarschijnlijk door meerdere geslachten wordt gebruikt en niet aan één specifiek geslacht kan worden toegewezen.

Question 2

Kunnen er verschillen zijn voor dezelfde naam per land?

Accepted Answer

Terwijl de naam Andrea in Italië mannelijk is, is die in Duitsland vrouwelijk en kan die in de VS zelfs beide zijn.
In dat geval geven we in het queryresultaat een nauwkeurigheidswaarde tussen 0 en 100 (of een waarschijnlijkheidswaarde tussen 0 en 1).
Die vertelt je hoe zeker we zijn dat we het juiste geslacht hebben bepaald.
Je kunt de kwaliteit van het API-resultaat sterk verbeteren door geografische informatie bij je query mee te geven. Dat kan een landcode, de locale van de browser of een IP-adres zijn. Meer over het lokaliseren van een query lees je in onze API-documentatie.

Question 3

Hoe verzamelen jullie de gegevens?

Accepted Answer

Om de hoogst mogelijke nauwkeurigheid te verschaffen, combineren we gegevens uit verschillende bronnen. De belangrijkste bronnen voor nieuwe records zijn openbare gegevens, overheidsgegevens en handmatige toevoegingen/correcties. Op basis van de bron van een nieuwe naam, kan het nodig zijn om de naam te verifiëren door middel van een tweede bron voordat deze aan onze lijst wordt toegevoegd.

Als we bijvoorbeeld een naam toevoegen op basis van openbare gegevens, kan deze naam een tweede verificatie nodig hebben, zoals een handmatige bevestiging, voordat deze definitief aan onze database wordt toegevoegd.

Je vindt een lijst van ondersteunde landen hier.

Question 4

Hoe vaak werken jullie de naamgegevens bij?

Accepted Answer

We werken onze gegevens regelmatig bij, afhankelijk van het land en de beschikbare openbare gegevens. De meeste westerse landen worden één keer per jaar bijgewerkt. Ook kan de verdeling van namen over de geslachten in de loop der jaren veranderen. Als een naam in de jaren 1970 bijvoorbeeld uitsluitend door vrouwen werd gebruikt, kan hij decennia later overwegend door mannen worden gebruikt. Daarom gebruiken we voor verschillende landen, zoals de VS, ook geboortegegevens om de resultaten te verrijken. Onze modellen proberen al deze factoren zo goed mogelijk mee te wegen. De geretourneerde nauwkeurigheidswaarde wordt regelmatig aangepast om het werkelijke gebruik in de bevolking zo nauwkeurig mogelijk weer te geven. De waarde is bedoeld als een redelijke beoordeling op basis van de laatste decennia en kan een mogelijke schommeling uitdrukken. We kijken naar ongeveer de laatste 4 decennia van de gegevens. Als je een zoekopdracht uitvoert en een jaar later dezelfde zoekopdracht herhaalt, kan het resultaat anders zijn, omdat ons systeem oude gegevens kan hebben verwijderd en er nieuwe gegevens bij kunnen zijn gekomen. Elke keer dat er nieuwe gegevens bij komen, voeren we daarna zogenoemde integratietests uit. Daarbij wordt onze API getest tegen een eerder gevalideerde dataset om de kwaliteit te waarborgen. Deze dataset wordt continu uitgebreid met namen en testgevallen om de breedst mogelijke dekking te bereiken.

Question 5

Hoe gebruiken jullie AI?

Accepted Answer

Kunstmatige intelligentie (AI) wordt dagelijks gebruikt om de kwaliteit van onze database en API resultaten te verbeteren. Met behulp van AI kunnen we efficiënt en nauwkeurig nieuwe vermeldingen aan onze database toevoegen, zodat onze informatie altijd up-to-date is.

Bovendien speelt AI ook een cruciale rol bij het verbeteren van de algehele kwaliteit van onze API-resultaten. Door gebruik te maken van machine learning algoritmes kunnen we data effectiever analyseren, patronen identificeren en meer nauwkeurige en relevante resultaten aan onze gebruikers bieden.

Question 6

Bieden jullie hulp bij het implementeren van de API?

Accepted Answer

Ja, we bieden e-mailsupport voor alle klanten. Je kunt ons e-mailen op contact gender-api.com. We reageren dan zo snel mogelijk. Je vindt hier ook codevoorbeelden. Let op: we kunnen je niet met elke programmeertaal en elk gebruiksscenario helpen. In de meeste gevallen kun je in je app een standaard REST-client gebruiken om onze API te bevragen. Veel libraries ondersteunen ook het importeren van een OpenAPI-definitiebestand. Je kunt ons definitiebestand openapi.yml hier downloaden.

Question 7

Wat als we een hoog nauwkeurigheidsniveau nodig hebben?

Accepted Answer

Talen en namen zijn veranderlijk en veranderen in de loop van de tijd. Ook verschillen datasets van klant tot klant sterk in kwaliteit, omvang en herkomst. Daarom kunnen we niet garanderen dat alle resultaten die je van onze API krijgt 100% juist zijn en overeenkomen met je eigen gegevens. Maar we beloven je dat we ons altijd inzetten voor de best mogelijke resultaten en dat we onze algoritmes regelmatig verbeteren en bijwerken. Ook voegen we heel regelmatig nieuwe gegevens toe. Meer over onze updates lees je hier. Mocht onze service onverhoopt niet aan je verwachtingen voldoen, dan geven we je een eenvoudige niet-goed-geld-terug-garantie van 14 dagen.
Je kunt onze service natuurlijk ook helemaal gratis testen. Als je je hier aanmeldt, krijg je 100 verzoeken gratis, elke maand.
Als je een naam opvraagt, retourneren onze endpoints een nauwkeurigheids- of een waarschijnlijkheidswaarde in de respons, afhankelijk van je API-versie.
De parameter accuracy geeft aan hoe zeker we zijn dat deze naam mannelijk of vrouwelijk is. De waarde wordt berekend aan de hand van het aantal records dat we hiervoor in onze database hebben.
Omdat gebruiksscenario's sterk verschillen, geven we geen aanbevelingen over het nauwkeurigheidsniveau. Afhankelijk van je gebruiksscenario bepaal je zelf welke resultaten en nauwkeurigheidsniveaus je accepteert.
Zelfs bij een nauwkeurigheid van minstens 99% bestaat de kans dat het resultaat onjuist is.
Een waarde boven 95% past over het algemeen echter bij de meeste gebruiksscenario's.

Question 8

Hoeveel namen hebben jullie in de database staan?

Accepted Answer

Onze database bevat 6,084,389 gevalideerde namen uit 191 verschillende landen. Over de hele wereld slaan we 6,471,712 unieke namen op. Gemiddeld analyseren we ongeveer 10.000.000 datasets per maand om de kwaliteit van onze resultaten te verbeteren.

Question 9

Welke landen worden ondersteund?

Accepted Answer

De API ondersteunt 191 landen volledig. Volledige ondersteuning betekent dat we in dat land ten minste  namen hebben verzameld. In de meeste landen is onze dataset echter veel groter. Bekijk de volgende tabel om te zien hoeveel namen we per land ondersteunen. Houd er rekening mee dat je, als we voor een land zelf geen geschikte ondersteuning bieden, de opgevraagde namen nog altijd tegen de hele dataset kunt laten zoeken om een bruikbaar resultaat te krijgen.

Question 10

Ondersteunen jullie Arabische namen?

Accepted Answer

Ja, onze API ondersteunt Arabische namen. Ze kunnen ook worden geschreven met tekens uit het Arabische alfabet.
Arabisch wordt van rechts naar links geschreven in een verbonden schrift en heeft 28 letters.
Als je bijvoorbeeld "عبد ال" opvraagt, krijg je het volgende resultaat: "gender": "male", "accuracy": 100.
De Arabische naam "عبد ال" is in dit voorbeeld url-encoded en de query-URL ziet er zo uit: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
Je vindt hier een volledige lijst met ondersteunde landen.

Question 11

Kan ik meerdere namen in één verzoek opvragen?

Accepted Answer

Ja, dat kan zeker. Je kunt maximaal 100 namen tegelijk opvragen.
Bekijk voor meer informatie onze API-documentatie.

Question 12

Ik heb over jullie e-mail-API gehoord. Wat is dat precies?

Accepted Answer

Onze e-mail-API kan namen uit e-mailadressen halen en het bijbehorende geslacht bij dat adres geven. Daarmee kun je je mailings personaliseren met een passende aanhef. Uit het e-mailadres "marie.johnson@gmail.com" haalt de API bijvoorbeeld de naam "Marie" en bepaalt het juiste geslacht, namelijk "female". Bekijk voor meer informatie onze API-documentatie.

Question 13

Ik heb een grote hoeveelheid data. Kan ik een CSV-bestand in bulk uploaden?

Accepted Answer

Als geregistreerde gebruiker kun je elk CSV-bestand met een kolom met voornamen uploaden. Voor een beter resultaat kun je optioneel een landkolom aan je dataset toevoegen. Je hoeft de kolommen niet speciaal te benoemen: onze assistent leidt je door het proces en laat je kiezen welke kolom welk gegeven bevat, inclusief voornaam of land.
Je vindt de functie in je account. Verwerkte records worden als verzoeken in rekening gebracht, zodat je elke maand gratis een CSV-bestand met maximaal 100 regels kunt uploaden. Voor de CSV-bulkupload heb je een Gender-API.com-account nodig. Om redenen van gegevensbescherming worden geüploade bestanden na één jaar automatisch verwijderd.

Question 14

Hoe moet het CSV-bestand worden opgemaakt?

Accepted Answer

We ondersteunen CSV-bestanden die zijn gemaakt op Windows, MacOS of Linux.
Daarnaast ondersteunen we bestanden met scheidingstekens zoals ";", "," of een tab. Het aanhalingsteken moet een " zijn.
Je kunt bovendien meerregelige CSV-bestanden uploaden met maximaal 10.000.000 rijen en 301MB.
We raden een CSV-bestand in UTF-8 aan met een puntkomma als scheidingsteken, voor het best mogelijke resultaat.
Verder mag het CSV-bestand nog andere, willekeurige kolommen bevatten; die komen ook in het uitvoerbestand terecht.
Het bestand moet ten minste één kolom hebben met alleen voornamen of een kolom met volledige namen.
Klik hier om een voorbeeldbestand te downloaden. Maak een Gender-API.com-account aan om een CSV-bestand te uploaden.

Question 15

Kan ik een Excel-bestand uploaden?

Accepted Answer

Je kunt Excel-bestanden uploaden met maximaal 300.000 rijen. Gebruik voor grotere datasets onze CSV-upload.
We ondersteunen .xlsx-bestanden met één werkblad. Als je een bestand met meer dan één werkblad uploadt, wordt alleen het eerste verwerkt.
De eerste rij van je werkblad moet de kolomnamen bevatten. Het bestand moet ten minste één kolom met voornamen bevatten; de landkolom is optioneel. Om redenen van gegevensbescherming worden geüploade bestanden na één jaar automatisch verwijderd. Download het voorbeeldbestand hier. Voorbeeld:

Question 16

Ik heb een bug gevonden. Wat moet ik doen?

Accepted Answer

We waarderen je hulp enorm. Stuur ons een e-mail op contact gender-api.com, dan proberen we deze bug zo snel mogelijk op te lossen.

Question 17

Voldoet Gender-API aan de Algemene Verordening Gegevensbescherming (AVG / GDPR)?

Accepted Answer

Alle diensten van Gender-API.com voldoen volledig aan de GDPR.
We bieden een verwerkersovereenkomst (DPA) aan, waarmee je aan je GDPR-verplichtingen kunt voldoen.
Je kunt deze overeenkomst hier in je account aanvragen. Een voorbeeldovereenkomst kun je hier downloaden.
Ook vind je hier meer informatie over hoe wij je gegevens beschermen.

Question 18

Bieden jullie bibliotheken aan voor programmeertalen?

Accepted Answer

Vanwege de eenvoud van onze API bieden we voor geen enkele programmeertaal een library aan, behalve de jQuery-plug-in. De meeste talen hebben standaard een json-parser en voor bijna elke andere taal bestaat er al een externe library die je kunt gebruiken. Bekijk onze codevoorbeelden om met de API aan de slag te gaan:

Question 19

Hoe worden verzoeken geteld?

Accepted Answer

Elk account wordt op de eerste dag van elke maand weer aangevuld tot 100 verzoeken als er minder dan dit aantal verzoeken over is.
Een verzoek wordt alleen geteld als er een resultaat is gevonden. Eén naamopzoeking telt als één verzoek.
Als je meerdere namen in één query opvraagt, wordt elke naam als een afzonderlijk verzoek geteld.

Question 20

Waar kan ik mijn API-sleutels vinden en beheren?

Accepted Answer

We genereren een eerste API-sleutel wanneer je een Gender-API.com-account aanmaakt. Je kunt deze API-sleutel onderaan je accountoverzichtspagina vinden. Als je deze sleutel wilt intrekken, klik dan op de knop "Intrekken en opnieuw genereren". 
        Ons systeem zal vervolgens de bestaande API-sleutel ongeldig maken en een nieuwe genereren. Al je toepassingen die de oude token gebruiken, hebben geen toegang meer tot onze API totdat je deze code vervangt door de nieuwe API-sleutel. [apiKeyImage] 
        Je kunt ook meer dan één API-sleutel creëren. Dit is handig, bijvoorbeeld als je meerdere toepassingen hebt waarin je onze API wilt opnemen. Let op: er wordt geen onderscheid gemaakt tussen de sleutels en het aantal verzoeken dat elke sleutel heeft gebruikt. Alle verzoeken worden bij elkaar geteld. Om meerdere API-sleutels te beheren of aan te maken, klik je op de knop "Instellingen" in het accountmenu en daarna op "API-sleutels".
[multipleKeysImage] Door op de knop "Nieuwe sleutel aanmaken" te klikken, genereer je een nieuwe API-sleutel. Je kunt elk token een naam geven, zodat je later gemakkelijker terugvindt waar de sleutel is gebruikt. Je kunt die naam op elk moment wijzigen. Sommige van onze widgets genereren hier ook automatisch een sleutel. Als je bijvoorbeeld onze "Quick Lookup Widget" in je account gebruikt, maakt ons systeem alvast een sleutel aan, die de widget vervolgens gebruikt om onze API te bevragen.
Ook apps van derden maken hier een sleutel aan zodra ze verbonden zijn. Elk token kun je op elk moment intrekken door simpelweg op de "x" te klikken. Zodra een token is ingetrokken, heeft de verbonden applicatie geen toegang meer tot onze API.

Question 21

Kan ik mijn account delen met meerdere personen?

Accepted Answer

Je kunt je account delen met nog eens 50 collega's of andere mensen die bij je project betrokken zijn. Om je team te beheren, log je in op je account en klik je in het accountmenu op "Instellingen" => "Je team beheren". Klik op die pagina op de knop "Een nieuw lid uitnodigen" om mensen via e-mail voor je team uit te nodigen. Bij het uitnodigen van leden kun je kiezen tussen twee accounttypen.
A) Gebruikers kunnen API-sleutels bekijken, aanmaken, bijwerken en verwijderen, CSV- en Excel-bestanden uploaden en daarin het geslacht bepalen, alle API-endpoints gebruiken, verzoeken kopen en apps van derden verbinden. B) Beheerders kunnen hetzelfde als gebruikers, en daarnaast accountinstellingen en factuuradres bijwerken, verwerkersovereenkomsten aanmaken en bekijken en teamleden uitnodigen, bijwerken en verwijderen.

Question 22

Kan ik mijn account beschermen door tweestapsverificatie in te schakelen?

Accepted Answer

Je kunt je account beveiligen door tweestapsverificatie in te schakelen. Log in op je account om deze extra beveiligingsmaatregel aan te zetten en klik in het menu op "Instellingen" => "Wachtwoord wijzigen / 2FA". Zorg dat je een authenticator-app op je telefoon hebt staan. We raden een app aan zoals Authy (App Store, Play Store) of Google Authenticator (App Store, Play Store).
Klik daarna op de knop "Nu inschakelen" en volg de instructies op het scherm. Je kunt hier meerdere apparaten toevoegen, zodat je bijvoorbeeld nog steeds toegang tot je account hebt als je een apparaat verliest.
Zodra tweestapsverificatie aan staat, moet je bij het inloggen de code invoeren die de authenticator-app op je telefoon genereert.

Question 23

Kan ik externe apps gebruiken wanneer tweestapsverificatie is ingeschakeld?

Accepted Answer

Sommige integraties of apps van derden werken zonder problemen met tweestapsverificatie aan. Andere vragen misschien om een verbinding zonder tweestapsverificatie. Als je problemen hebt om met je Gender-API.com-gegevens in te loggen bij een app, log dan rechtstreeks in op je account bij Gender-API en klik in het accountmenu op "Instellingen" => "Wachtwoord wijzigen / 2FA". Klik daarna op het tabblad "Tweestapsverificatie" en zet "Toegang voor apps van derden" op "Niet beperkt". Let op: je kunt deze instelling alleen wijzigen als tweestapsverificatie is ingeschakeld.

Question 24

Wat zijn passkeys en hoe werken ze?

Accepted Answer

Passkeys zijn een moderne, wachtwoordloze manier om in te loggen en bieden sterkere beveiliging dan traditionele wachtwoorden.  
In plaats van een wachtwoord in te voeren, meld je je aan met de ingebouwde beveiligingsfuncties van je apparaat, zoals Face ID, Touch ID, Windows Hello of een pincode.  
Passkeys zijn gebaseerd op de WebAuthn-standaard en zijn phishingbestendig omdat ze cryptografisch gekoppeld zijn aan specifieke websites.  
Je privésleutel verlaat je apparaat nooit, waardoor passkeys veiliger zijn dan wachtwoorden. Zodra je een passkey hebt ingesteld voor je Gender-API.com-account,  
log je in met één tik of blik — zonder wachtwoord. Passkeys werken op al je apparaten en kunnen worden gesynchroniseerd via iCloud-sleutelhanger, Google Password Manager of vergelijkbare diensten.

Question 25

Hoe stel ik een passkey in voor mijn account?

Accepted Answer

Het instellen van een passkey gebeurt automatisch tijdens het inloggen. Wanneer je je aanmeldt met je e-mailadres en wachtwoord, krijg je de vraag om een passkey aan te maken voor sneller inloggen in de toekomst. Volg simpelweg de stappen op je apparaat – je browser vraagt je om je identiteit te bevestigen met Face ID, Touch ID, Windows Hello of de pincode van je apparaat. Zodra je identiteit is bevestigd, wordt de passkey automatisch op je apparaat opgeslagen en is hij klaar voor gebruik. De volgende keer dat je Gender-API.com bezoekt, kun je direct inloggen met alleen je passkey, zonder je wachtwoord te hoeven typen.  

Je kunt het instellen van een passkey ook overslaan als je liever je wachtwoord blijft gebruiken.  

Let op: passkeys vereisen een compatibele browser (Chrome, Safari, Edge, Firefox) en besturingssysteem.

Question 26

Hoe verschillen passkeys van tweestapsverificatie (2FA)?

Accepted Answer

Hoewel ze allebei de beveiliging verbeteren, werken ze op een andere manier. Tweestapsverificatie (2FA) voegt een tweede factor toe nadat je je wachtwoord hebt ingevoerd – meestal een code uit een authenticator-app. Passkeys vervangen je wachtwoord volledig en bieden multifactorbeveiliging in één stap door een combinatie van iets dat je hebt (je apparaat) met iets dat je bent (biometrie) of weet (apparaat-PIN).

Passkeys worden als veiliger beschouwd omdat ze:
- phishingbestendig zijn (ze werken alleen op de echte, authentieke website),
- niet kwetsbaar zijn voor datalekken van wachtwoorddatabases,
- niet te raden of te kraken zijn.

Als je zowel passkeys als 2FA hebt ingeschakeld, dan sla je bij inloggen met een passkey de 2FA-melding over, omdat passkeys al dezelfde of zelfs sterkere beveiliging bieden.

Question 27

Wat gebeurt er als ik het apparaat met mijn passkey kwijtraak?

Accepted Answer

Als je een apparaat kwijtraakt met je passkey, geen zorgen — je account blijft veilig en toegankelijk.  
Je kunt altijd inloggen met je wachtwoord (en 2FA als dat is ingeschakeld). Als je passkeys worden gesynchroniseerd via iCloud-sleutelhanger of Google Password Manager,  
zijn ze automatisch beschikbaar op je andere apparaten waarop je met hetzelfde account bent ingelogd.  
Voor optimale beveiliging raden we aan: passkeys op meerdere apparaten in te stellen, je wachtwoord als back-up te bewaren,  
en 2FA in te schakelen als extra beveiligingslaag. Je kunt ook je passkeys beheren in je accountinstellingen om de passkey van een kwijtgeraakt apparaat te verwijderen  
en mogelijke ongeautoriseerde toegang te voorkomen.

Question 28

Wat is het verschil tussen een betaald en gratis account?

Accepted Answer

Beide accounttypen bieden dezelfde functionaliteit. Alle API-endpoints zijn beschikbaar voor beide accounttypen en geven dezelfde resultaten terug.
Gratis accounts zijn beperkt tot een bepaald aantal verzoeken per maand. Bij aanmelding zijn 100 verzoeken direct gratis beschikbaar. Op de eerste dag van elke maand zet ons systeem dit aantal terug en zijn de gratis verzoeken weer beschikbaar. Maak alsjeblieft maar één account aan. Heb je meer verzoeken nodig, dan kun je op elk moment hier upgraden naar een van onze betaalde pakketten.

Question 29

Hoe kan ik uitloggen op alle apparaten?

Accepted Answer

Als je in je account op de uitlogknop klikt, word je alleen op het huidige apparaat uitgelogd.
Om de veiligheid van je account en je gegevens te waarborgen, is het belangrijk om je waar nodig op alle apparaten uit te loggen. Volg de onderstaande instructies om je op ons API-platform op alle apparaten uit te loggen.
Klik hier als je bent ingelogd om je op alle apparaten uit te loggen. Als je je wachtwoord wijzigt of je instellingen voor tweestapsverificatie aanpast, logt het systeem je automatisch uit op alle apparaten die niet overeenkomen met je huidige IP-adres. Dat voegt een extra laag beveiliging toe aan je account. We raden aan om aparte accounts aan te maken voor elk teamlid, om de veiligheid te verhogen en de samenwerking in het team te vergemakkelijken.
Verder raden we je sterk aan om tweestapsverificatie (2FA) in te schakelen om je account nog beter te beveiligen. Deze extra beschermingslaag voegt een stap toe aan het inlogproces, waardoor het moeilijker wordt voor onbevoegden om toegang te krijgen.

Question 30

Wat is het verschil tussen een abonnement en een eenmalige betaling?

Accepted Answer

Als je een van onze pakketten wilt kopen, kun je kiezen tussen een eenmalige betaling of een abonnement op dit pakket.
Abonnementen worden aanbevolen als je onze service regelmatig wilt gebruiken. Je bent er dan van verzekerd dat er altijd genoeg verzoeken op je account overblijven.
Verzoeken die je met een abonnement koopt, kun je binnen één maand gebruiken. Bij een actief abonnement vult ons systeem je account na een maand weer aan tot het gekozen aantal verzoeken.
Als je bijvoorbeeld geabonneerd bent op ons pakket van 25.000 verzoeken en je hebt er 21.500 gebruikt, dan vult ons systeem je account na een maand weer aan tot 25.000 verzoeken.
Eenmalige pakketten koop je voor één specifiek doel en kun je binnen één jaar gebruiken. Als je bijvoorbeeld een Excel- of CSV-bestand wilt verwerken, raden we de eenmalige aankoop aan.
Eenmalige aankopen worden niet verlengd. Je moet er zelf op letten dat je niet zonder verzoeken komt te zitten.
Je kunt op onze aankooppagina tussen beide pakkettypen schakelen.

[difference]
Meng de twee aankooptypes niet zonder eerst met onze support te overleggen of precies te weten wat je doet. Een eenmalig pakket kopen terwijl je op een van onze pakketten geabonneerd bent, kan ervoor zorgen dat het abonnement je verzoeken niet meer aanvult, bijvoorbeeld wanneer er van de eenmalige aankoop meer verzoeken over zijn dan het abonnement zou aanvullen.

Question 31

Ik heb een woonplaatsverklaring nodig. Kunnen jullie zo'n verklaring afgeven?

Accepted Answer

Als je een woonplaatsverklaring van ons bedrijf nodig hebt, neem dan contact op met onze support en vermeld je verzoek. De verklaring moet voor elk bedrijf afzonderlijk worden aangevraagd. Vermeld in je verzoek het volledige adres van je bedrijf, je land van vestiging en, als je die hebt, je belastingnummer.
De woonplaatsverklaring moet door onze Belastingdienst worden ondertekend. Het duurt gewoonlijk 2-3 weken voordat we het ondertekende formulier terugkrijgen; daarna kunnen we het als digitale scan aan je doorgeven.

[certificate-of-residence]

Question 32

Hoe kan ik een pakket/meer verzoeken kopen?

Accepted Answer

Je kunt hier kiezen tussen een abonnement of een eenmalige betaling.
Een eenmalige betaling raden we aan als je een groot CSV-bestand wilt verwerken of als je je verzoeken onregelmatig gebruikt.
Je kunt je account op elk moment aanvullen met het aantal verzoeken dat je nodig hebt. Verzoeken die je met een eenmalige betaling koopt, kun je binnen één jaar gebruiken.
Kies je liever een abonnement, dan wordt je account elke maand weer aangevuld tot het gekozen aantal verzoeken.
Abonnementen kun je op elk moment wijzigen of opzeggen.

Question 33

Hoe kan ik mijn abonnement opzeggen?

Accepted Answer

Je kunt je abonnement altijd hier wijzigen of opzeggen. Wil je je terugkerende betalingen stoppen, klik dan op de knop "Dit abonnement opzeggen".

Question 34

Wat is de typische API-responstijd?

Accepted Answer

Onze API is ontworpen voor hoge prestaties en reageert meestal binnen 10-200 milliseconden.  
De responstijden kunnen licht variëren afhankelijk van je geografische locatie, netwerkcondities en de complexiteit van je query.  
Bij batchverzoeken met meerdere namen schaalt de responstijd lineair. We gebruiken een wereldwijd CDN en geoptimaliseerde infrastructuur om wereldwijd een lage latency te garanderen. Als je consequent trage responstijden ervaart, neem dan contact op met ons ondersteuningsteam.

Question 35

Zijn er rate limits of beperkingen op het aantal verzoeken?

Accepted Answer

We hanteren eerlijke gebruikslimieten om een optimale service voor alle gebruikers te garanderen.  
Gratis accounts kunnen tot 100 verzoeken per maand doen. Betaalde accounts hebben hogere limieten:  
1500 verzoeken per minuut en geen dagelijkse beperkingen, zolang je nog credits beschikbaar hebt.  
Als je voor jouw specifieke usecase hogere limieten nodig hebt, neem dan contact met ons op om een aangepast plan te bespreken.  
Batch-verzoeken (tot 100 namen per verzoek) tellen als afzonderlijke verzoeken, maar zijn efficiënter.

Question 36

Wat is jullie uptime-garantie voor de API?

Accepted Answer

We garanderen 99.9% API-uptime op alle betaalde abonnementen. Onze infrastructuur wordt gehost op servers van ondernemingsniveau met automatische failover en load balancing. We bewaken onze systemen continu, 24/7, en hebben geautomatiseerde waarschuwingen voor eventuele problemen.  
We bieden ook een Service Level Agreement (SLA) voor zakelijke klanten. In het zeldzame geval van langdurige uitvaltijd ontvangen betalende klanten automatisch servicecredits op basis van onze SLA-voorwaarden.

Question 37

Welk formaat gebruikt de API-respons?

Accepted Answer

Onze API geeft standaard antwoorden terug in JSON-formaat, dat breed wordt ondersteund door alle moderne programmeertalen. Elk antwoord bevat de opgevraagde naam, het gedetecteerde geslacht, een nauwkeurigheids-/waarschijnlijkheidswaarde en extra metadata. Bijvoorbeeld: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}. Je vindt gedetailleerde antwoordschema’s in onze API-documentatie en je kunt onze OpenAPI-specificatie downloaden voor automatische clientgeneratie.

Question 38

Hoe kan ik API-fouten het beste afhandelen?

Accepted Answer

Onze API gebruikt standaard HTTP-statuscodes om succes of fouten aan te geven.
200 betekent succes, 401 duidt op een ongeldige API-sleutel, 429 betekent dat de rate limit is overschreden en 500 duidt op een serverfout.
Elke foutrespons bevat een beschrijvende melding en een foutcode, zodat debuggen eenvoudig is.
We raden aan om exponentiële back-off te implementeren voor rate-limitfouten en geslaagde responses waar mogelijk te cachen.
Bij aanhoudende fouten kun je onze API-documentatie raadplegen of contact opnemen met onze support.
Alle fouten worden gelogd om problemen te kunnen oplossen.

Question 39

Hoe gaan jullie om met API-versies?

Accepted Answer

We onderhouden momenteel twee API-versies: V1 en V2. V2 is onze nieuwste versie met uitgebreide functies, waaronder waarschijnlijkheidswaarden, uitgebreide landondersteuning en verbeterde nauwkeurigheid. V1 blijft beschikbaar voor achterwaartse compatibiliteit, maar we raden je aan om voor nieuwe integraties over te stappen naar V2. Alle API-endpoints bevatten de versie in het URL-pad (bijv. /v2/name). We garanderen dat oudere API-versies blijven werken. Migratiehandleidingen zijn beschikbaar in onze API‑documentatie. Ingrijpende wijzigingen worden altijd ruim van tevoren gecommuniceerd.

Question 40

Hoe gaan jullie om met naamvarianten en bijnamen?

Accepted Answer

Onze database bevat veelvoorkomende naamvarianten, verkortingen en bijnamen. Zo wordt  
„Bob” herkend als een variant van „Robert” en „Liz” als een variant van „Elizabeth”. We raden je echter aan om, wanneer mogelijk, altijd de volledige voornaam op te vragen voor de beste nauwkeurigheid.  

Onze AI‑systemen leren continu nieuwe naamvarianten uit onze dataset. Als je een bijnaam tegenkomt die niet wordt herkend, laat het ons dan weten en we voegen deze toe aan onze database.  

Regionale varianten (zoals „Juan” vs „John”) worden verwerkt via onze landspecifieke datasets.

Question 41

Ondersteunt de API namen met speciale tekens en accenten?

Accepted Answer

Ja! Onze API ondersteunt volledig Unicode-tekens, inclusief letters met accenten (é, ñ, ü),  
umlauts, diakritische tekens en niet-Latijnse schriften (Arabisch, Cyrillisch, Chinees, enz.). Namen moeten in UTF-8  
gecodeerd zijn in je API-verzoeken. Bijvoorbeeld: "François", "José", "Müller" en "Søren" worden allemaal correct verwerkt.  
URL-codering wordt automatisch afgehandeld door de meeste HTTP-clients, maar zorg voor de juiste codering van speciale tekens.  
Onze database bevat namen uit 191 landen en dekt alle grote schriftsystemen. Meer details vind je in onze API-documentatie.

Question 42

Welke gegevensbronnen gebruiken jullie?

Accepted Answer

We combineren meerdere gezaghebbende databronnen om maximale nauwkeurigheid te garanderen. Deze omvatten: 
        gegevens uit volkstellingen van overheden en geboorteakten uit tal van landen, openbaar beschikbare naamdatabanken, 
        sociale media en professionele netwerken (geanonimiseerd en AVG-conform), historische naamgegevens, 
        en handmatige controles door ons datateam. Alle databronnen worden zorgvuldig beoordeeld en gekruist gecontroleerd. 
        Waar mogelijk geven we prioriteit aan officiële overheidsbronnen. Onze AI-modellen helpen ook patronen te herkennen en 
        de consistentie tussen bronnen te verifiëren. Een volledige lijst met ondersteunde landen is hier beschikbaar. 
        We werken onze database regelmatig bij zodra er nieuwe officiële gegevens beschikbaar komen.

Question 43

Hoe waarborgen jullie privacy en gegevensbescherming?

Accepted Answer

We nemen privacy heel serieus en voldoen aan de GDPR, CCPA en andere internationale regels voor gegevensbescherming. We slaan de namen die je opvraagt niet op, behalve voor de logging die nodig is om de dienst te laten werken. Alle API-communicatie is versleuteld via HTTPS/TLS. Voor zakelijke klanten bieden we verwerkersovereenkomsten aan. Je geüploade CSV-/Excel-bestanden worden na één jaar automatisch verwijderd. We verkopen of delen klantgegevens nooit met derden. Onze servers staan in beveiligde Europese datacenters. Lees ons volledige privacybeleid voor alle details. Regelmatige beveiligingsaudits zorgen voor voortdurende naleving.

Question 44

Kan ik facturen en betalingsbewijzen voor mijn betalingen krijgen?

Accepted Answer

Ja, facturen worden automatisch aangemaakt voor alle aankopen en zijn te vinden in je accountoverzicht. Je kunt op elk moment pdf-facturen downloaden en ze worden ook naar je geregistreerde e-mailadres gestuurd. Facturen bevatten alle gegevens die je voor de boekhouding nodig hebt, inclusief btw-informatie waar die van toepassing is. Je kunt je facturatie- en bedrijfsgegevens op elk moment bijwerken, zodat op facturen de juiste informatie staat. Voor oudere facturen of bijzondere factuureisen kun je contact opnemen met support.

Question 45

Wat is jullie restitutiebeleid?

Accepted Answer

We bieden een eenvoudige geld-terug-garantie van 14 dagen voor eerste aankopen.  
Als onze service binnen de eerste 14 dagen niet aan je verwachtingen voldoet, neem dan contact met ons op voor een volledige terugbetaling – zonder vragen te stellen.  
Bij abonnementsbetalingen kun je op elk moment opzeggen om toekomstige kosten te stoppen. Ongebruikte credits van eenmalige aankopen  
blijven één jaar geldig. We bieden ook restituties voor technische problemen of storingen in de service, per geval beoordeeld.  
Lees alsjeblieft ons volledige annuleringsbeleid voor alle details of neem contact op met de ondersteuning als je vragen hebt.

Question 46

Welke integraties van derden zijn beschikbaar?

Accepted Answer

We bieden integraties met populaire platforms en tools, waaronder Zapier, Make (voorheen Integromat),
Google Sheets, Microsoft Excel, Salesforce, HubSpot en veel CRM-systemen. Onze API werkt met elk platform dat
REST-API's of webhooks ondersteunt. We bieden kant-en-klare connectors en gedetailleerde integratiehandleidingen voor de belangrijkste platforms.
Je kunt ook onze CSV-uploadfunctie gebruiken voor eenmalige gegevensverwerking, zonder enige integratie.
Voor eigen integraties of ondersteuning van een specifiek platform kun je onze documentatie raadplegen of contact opnemen met onze support.

VEELGESTELDE VRAGEN