Command Line Client;;Opdrachtregelclient
Verrijk gegevens rechtstreeks vanuit je terminal
Onze nieuwe Command Line Client is een statisch gecompileerde, razendsnelle tool gebouwd in Go. Hiermee kunnen developers en data scientists rechtstreeks vanuit hun terminal met Gender-API.com werken, zonder dat je wrappercode hoeft te schrijven.
Het draait native op macOS en Linux, waardoor het perfect past bij geautomatiseerde bash-scripts, cronjobs of integratie in je lokale data science-pipelines.
Belangrijkste voordelen
- Cross-platform: Wordt gecompileerd tot één uitvoerbaar bestand voor macOS, Linux en Windows.
- Snel & lichtgewicht: Gebouwd in Go voor maximale uitvoersnelheid en nul runtime-afhankelijkheden.
- Pipe-vriendelijk: Stuur eenvoudig gegevens in en uit via standaard POSIX-streams. Integreer met sed, awk, jq of AI-tools zoals ClaudeBot.
- Dekking: Ondersteunt alle belangrijke V2-endpoints, waaronder Naam, E-mail, Land van herkomst en Accountstatistieken.
Hoe het werkt
Aan de slag met de CLI-client gaat snel en is heel eenvoudig.
1. Configureer je API-sleutel
Om je requests veilig te authenticeren zonder je sleutel in je bash-geschiedenis te loggen, kun je hem exporteren als een omgevingsvariabele of opslaan in een configuratiebestand.
Optie A: Omgevingsvariabele
export GENDER_API_KEY="your-api-key-here"
Optie B: Configuratiebestand
Maak in de homedirectory van je gebruiker een bestand aan met de naam .gender-api-key en zet er alleen je token in:
echo "your-api-key-here" > ~/.gender-api-key
2. De API raadplegen
Met de CLI kun je communiceren met alle belangrijke endpoints. Hier zijn een paar voorbeelden:
Zoek op voornaam
$ gender-api-cli -first_name "Sandra" -country "US"
Zoeken op volledige naam
$ gender-api-cli -full_name "Theresa Miller"
Zoeken op e-mailadres
$ gender-api-cli -email "thomasfreeman@example.com"
Bepaal het land van herkomst
Om erachter te komen waar een naam waarschijnlijk vandaan komt, voeg je simpelweg de -origin-flag toe:
$ gender-api-cli -first_name "Sandra" -origin
Accountstatistieken bekijken
Controleer snel je resterende credits zonder zoekopdrachten te verbruiken:
$ gender-api-cli -stats
3. Automatiseer met scripts
Bouw krachtige bash-scripts. Lees bijvoorbeeld namen uit een tekstbestand, query de API en voeg de resultaten toe aan een gestructureerd JSON-bestand dat geschikt is voor invoer in ClaudeBot of ChatGPT.
#!/bin/bash
while read name; do
gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt
Veelgestelde vragen
Is de CLI-client open source?
Ja, de CLI is volledig open-source. Je kunt de code bekijken, verbeteringen voorstellen of ’m zelf vanaf de broncode compileren via onze GitHub-repository.
Ondersteunt het bulkverwerking?
Op dit moment ondersteunt de CLI het uitvoeren van één API-aanvraag tegelijk, maar hij is ontworpen om extreem snel te zijn. Voor duizenden regels kun je eenvoudig xargs of een bash-loop gebruiken. Voor enorme datasets met miljoenen regels raden we nog steeds onze CSV/Excel-uploadfunctie in het dashboard aan.
Kan ik onbewerkte JSON uitvoeren?
Ja! Je kunt de vlag **"-out=json"** meegeven om de onopgemaakte, ruwe JSON-respons direct naar de standaarduitvoer te sturen—ideaal voor jq-processor chains.
Zegt macOS: "Apple kon niet verifiëren dat het vrij is van malware"?
Omdat de CLI rechtstreeks als binaire download wordt binnengehaald en niet via de App Store wordt geïnstalleerd, blokkeert macOS Gatekeeper dit standaard. Om uitvoeren toe te staan, open je Terminal en verwijder je de quarantaine-flag met:
xattr -d com.apple.quarantine /path/to/downloaded/executable
Heb je vragen?
