Client-Bibliotheken
Dünne Wrapper über der REST API. Sie senden Ihren Schlüssel mit, bauen jede Anfrage auf und wandeln Fehlerantworten in Exceptions um.
Sie benötigen keine. Die API besteht aus einer Handvoll einfacher JSON-Endpoints; eine Bibliothek spart Ihnen einen Nachmittag, kein Projekt. Falls Ihre Sprache nicht aufgelistet ist, enthält die REST-Referenz Copy-Paste-Beispiele.
REST API Referenz →
JavaScript
Node.js · Deno · Bun · npm
npm install namegender
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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']);
Kopieren fehlgeschlagen. Text auswählen und kopieren.
Command line
macOS · Linux · Windows · Node.js 18+
npm install -g namegender
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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
Kopieren fehlgeschlagen. Text auswählen und kopieren.
PHP
PHP 8.1+
composer require namegender/namegender
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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']);
Kopieren fehlgeschlagen. Text auswählen und kopieren.
Python
Python 3.9+
pip install namegender-client
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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"])
Kopieren fehlgeschlagen. Text auswählen und kopieren.
Ruby
Ruby 3.0+
gem install namegender
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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>
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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());
Kopieren fehlgeschlagen. Text auswählen und kopieren.
C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
dotnet add package NameGender --version 0.6.0
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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);
Kopieren fehlgeschlagen. Text auswählen und kopieren.
Go
Go 1.21+
go get github.com/anpekesen/namegender-go@v0.7.0
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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)
Kopieren fehlgeschlagen. Text auswählen und kopieren.
R
R 4.1+ · GitHub
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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
Kopieren fehlgeschlagen. Text auswählen und kopieren.
PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
Install-Module NameGender
Kopieren fehlgeschlagen. Text auswählen und kopieren.
$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
Kopieren fehlgeschlagen. Text auswählen und kopieren.
Rust
async · reqwest + rustls · crates.io
cargo add namegender
Kopieren fehlgeschlagen. Text auswählen und kopieren.
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")
Kopieren fehlgeschlagen. Text auswählen und kopieren.
Benötigen Sie eine andere Sprache?
Teilen Sie uns mit, welche, und wir schauen sie uns an. Die API-Oberfläche ist klein genug, dass ein Community-Wrapper ein Wochenendprojekt ist, und wir werden es hier verlinken.
Support kontaktieren