Kommandoradsklient
Berika data direkt från din terminal
Vår nya kommandoradsklient är ett statiskt kompilerat verktyg med hög prestanda, byggt i Go. Den gör det enkelt för utvecklare och data scientists att använda Gender-API.com direkt i terminalen – helt utan att behöva skriva någon wrapper-kod.
Det körs direkt i macOS och Linux, vilket gör det perfekt för automatiserade bash-skript, cron-jobb eller för att integrera i dina lokala data science-flöden.
Viktigaste fördelarna
- Plattformsoberoende: Kompileras till en enda binärfil för macOS, Linux och Windows.
- Snabbt & lättviktigt: Byggd i Go för maximal körhastighet och noll körningsberoenden.
- Rörvänlig: Skicka enkelt data in och ut med standardiserade POSIX-strömmar. Integrera med sed, awk, jq eller AI-verktyg som ClaudeBot.
- Täckning: Stöder alla viktiga V2-endpoints, inklusive Namn, E-post, Ursprungsland och Kontostatistik.
Så funkar det
Att komma igång med CLI-klienten går snabbt och är enkelt.
1. Konfigurera din API-nyckel
För att autentisera dina förfrågningar säkert utan att logga nycklar i din bash-historik kan du antingen exportera den som en miljövariabel eller spara den i en konfigurationsfil.
Alternativ A: Miljövariabel
export GENDER_API_KEY="your-api-key-here"
Alternativ B: Konfigurationsfil
Skapa en fil med namnet .gender-api-key i din användares hemkatalog som bara innehåller din token:
echo "your-api-key-here" > ~/.gender-api-key
2. Fråga API:et
CLI:t låter dig interagera med alla viktiga endpoints. Här är några exempel:
Sök med förnamn
$ gender-api-cli -first_name "Sandra" -country "US"
Sök efter fullständigt namn
$ gender-api-cli -full_name "Theresa Miller"
Sök med e-postadress
$ gender-api-cli -email "thomasfreeman@example.com"
Fastställ ursprungsland
För att ta reda på var ett namn mest sannolikt kommer ifrån lägger du bara till flaggan -origin:
$ gender-api-cli -first_name "Sandra" -origin
Kontrollera kontostatistik
Kolla dina återstående krediter snabbt utan att förbruka några sökningar:
$ gender-api-cli -stats
3. Automatisera med skript
Bygg kraftfulla bash-skript. Till exempel: läs in namn från en textfil, gör API-anrop och lägg till resultaten i en strukturerad JSON-fil som passar för att matas in i ClaudeBot eller ChatGPT.
#!/bin/bash
while read name; do
gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt
Vanliga frågor
Är CLI-klienten open source?
Ja, CLI:t är helt och hållet open source. Du kan granska koden, föreslå förbättringar eller kompilera den från källkod via vårt GitHub-repo.
Stöder den massbearbetning?
Just nu kan CLI:t bara skicka en enskild API-fråga åt gången, men det är byggt för att vara extremt snabbt. För tusentals rader kan du enkelt använda xargs eller en bash-loop. För riktigt stora datamängder med miljontals rader rekommenderar vi fortfarande vår uppladdningsfunktion för CSV/Excel i dashboarden.
Kan jag mata ut rå JSON?
Ja! Du kan skicka med flaggan "-out=json" för att få tillbaka det oformaterade, råa JSON-svaret direkt till standardutdata, vilket gör det perfekt för jq-baserade kommandokedjor.
Säger macOS ”Apple kunde inte verifiera att den är fri från skadlig kod”?
Eftersom CLI:t laddas ner som en direkt binärfil och inte installeras via App Store skyddas det som standard av macOS Gatekeeper. För att tillåta körning, öppna Terminal och ta bort karantänflaggan med:
xattr -d com.apple.quarantine /path/to/downloaded/executable
Har du några frågor?
