Clientbibliotheken
Dunne wrappers rond de REST API. Ze sturen je sleutel mee, bouwen elk verzoek op en zetten foutresponses om in exceptions.
Je hebt er geen nodig. De API bestaat uit een handvol eenvoudige JSON-endpoints; een bibliotheek bespaart je een middag, niet een project. Als je taal niet vermeld staat, bevat de REST-referentie copy-paste-voorbeelden.
REST API Referentie →
JavaScript
Node.js · Deno · Bun · npm
npm install namegender
Kopiëren mislukt. Selecteer en kopieer de tekst.
import { NameGender } from 'namegender';
const client = new NameGender('YOUR_API_KEY');
const result = await client.name('Ayşe', { country: 'TR' });
console.log(result.gender); // "female"
console.log(result.confidence); // "unverified" | "low" | "medium" | "high"
// Many names in one request
const many = await client.bulk(['Ayşe', 'Mehmet', 'Priya']);
Kopiëren mislukt. Selecteer en kopieer de tekst.
Command line
macOS · Linux · Windows · Node.js 18+
npm install -g namegender
Kopiëren mislukt. Selecteer en kopieer de tekst.
export NAMEGENDER_API_KEY=YOUR_API_KEY
npx namegender Andrea --country IT
npx namegender --email jane.doe@example.com
# One value per line in, CSV out
cat names.txt | npx namegender --csv > genders.csv
Kopiëren mislukt. Selecteer en kopieer de tekst.
PHP
PHP 8.1+
composer require namegender/namegender
Kopiëren mislukt. Selecteer en kopieer de tekst.
use NameGender\Client;
$client = new Client('YOUR_API_KEY');
$result = $client->name('Ayşe', country: 'TR');
echo $result['gender']; // "female"
echo $result['confidence']; // "unverified" | "low" | "medium" | "high"
// Many names in one request
$many = $client->bulk(['Ayşe', 'Mehmet', 'Priya']);
Kopiëren mislukt. Selecteer en kopieer de tekst.
Python
Python 3.9+
pip install namegender-client
Kopiëren mislukt. Selecteer en kopieer de tekst.
from namegender import NameGender
client = NameGender("YOUR_API_KEY")
result = client.name("Ayşe", country="TR")
print(result["gender"]) # "female"
print(result["confidence"]) # evidence level
# Many names in one request
many = client.bulk(["Ayşe", "Mehmet", "Priya"])
Kopiëren mislukt. Selecteer en kopieer de tekst.
Ruby
Ruby 3.0+
gem install namegender
Kopiëren mislukt. Selecteer en kopieer de tekst.
require "namegender"
client = NameGender::Client.new("YOUR_API_KEY")
result = client.name("Ayşe", country: "TR")
puts result["gender"] # "female"
puts result["confidence"] # evidence level
Kopiëren mislukt. Selecteer en kopieer de tekst.
Java
Java 17+ · JitPack
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.anpekesen</groupId>
<artifactId>namegender-java</artifactId>
<version>v0.9.0</version>
</dependency>
Kopiëren mislukt. Selecteer en kopieer de tekst.
var client = new NameGender("YOUR_API_KEY");
var result = client.name("Ayşe", "TR");
System.out.println(result.gender()); // "female"
System.out.println(result.confidence());
Kopiëren mislukt. Selecteer en kopieer de tekst.
C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
dotnet add package NameGender --version 0.6.0
Kopiëren mislukt. Selecteer en kopieer de tekst.
using var client = new NameGenderClient("YOUR_API_KEY");
var result = await client.NameAsync("Ayşe", new LookupOptions { Country = "TR" });
Console.WriteLine(result.Gender); // "female"
Console.WriteLine(result.Confidence);
Kopiëren mislukt. Selecteer en kopieer de tekst.
Go
Go 1.21+
go get github.com/anpekesen/namegender-go@v0.7.0
Kopiëren mislukt. Selecteer en kopieer de tekst.
client := namegender.New("YOUR_API_KEY")
result, err := client.Name(ctx, "Ayşe", namegender.Options{Country: "TR"})
fmt.Println(result.Gender) // "female"
fmt.Println(result.Confidence)
Kopiëren mislukt. Selecteer en kopieer de tekst.
R
R 4.1+ · GitHub
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')
Kopiëren mislukt. Selecteer en kopieer de tekst.
library(namegender)
client <- namegender("YOUR_API_KEY")
result <- ng_name(client, "Ayşe", country = "TR")
result$gender # "female"
result$confidence
# A whole data frame in one call
df$gender <- ng_bulk(client, df$name)$results$gender
Kopiëren mislukt. Selecteer en kopieer de tekst.
PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
Install-Module NameGender
Kopiëren mislukt. Selecteer en kopieer de tekst.
$env:NAMEGENDER_API_KEY = 'YOUR_API_KEY'
Get-NameGender Andrea -Country IT
# A whole file: pipeline input goes out in bulk requests
Get-Content names.txt | Get-NameGender | Export-Csv genders.csv -NoTypeInformation
Kopiëren mislukt. Selecteer en kopieer de tekst.
Rust
async · reqwest + rustls · crates.io
cargo add namegender
Kopiëren mislukt. Selecteer en kopieer de tekst.
use namegender::{NameGender, Options};
let client = NameGender::new("YOUR_API_KEY");
let r = client
.name("Ayşe", &Options { country: Some("TR".into()), ..Default::default() })
.await?;
println!("{:?}", r.gender); // Some("female")
Kopiëren mislukt. Selecteer en kopieer de tekst.
Heb je een ander language nodig?
Zeg welke en we kijken ernaar. Het API-oppervlak is klein genoeg dat een community wrapper een weekend werk is, en we linken het hier.
Contact opnemen met support