Doorgaan → Overzicht

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
Installeren
npm install namegender

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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+
Installeren
npm install -g namegender

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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+
Installeren
composer require namegender/namegender

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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+
Installeren
pip install namegender-client

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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+
Installeren
gem install namegender

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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
Installeren
<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.

Gebruik
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
Installeren
dotnet add package NameGender --version 0.6.0

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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+
Installeren
go get github.com/anpekesen/namegender-go@v0.7.0

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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
Installeren
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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
Installeren
Install-Module NameGender

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
$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
Installeren
cargo add namegender

Kopiëren mislukt. Selecteer en kopieer de tekst.

Gebruik
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