続行 → 概要
NameGender
無料で登録

クライアントライブラリ

REST API の薄いラッパーです。API キーの送信、各リクエストの組み立て、エラーレスポンスの例外への変換を行います。

必須ではありません。API は少数のシンプルな JSON エンドポイントだけです。ライブラリで節約できるのは午後の数時間であり、プロジェクト全体ではありません。言語がリストにない場合は、REST リファレンスにコピー&ペーストできる例があります。

REST API リファレンス →
JavaScript
Node.js · Deno · Bun · npm
インストール
npm install namegender

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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']);

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
Command line
macOS · Linux · Windows · Node.js 18+
インストール
npm install -g namegender

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
PHP
PHP 8.1+
インストール
composer require namegender/namegender

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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']);

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
Python
Python 3.9+
インストール
pip install namegender-client

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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"])

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
Ruby
Ruby 3.0+
インストール
gem install namegender

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
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>

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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());

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
C# / .NET
.NET Standard 2.0 · .NET 8 · NuGet
インストール
dotnet add package NameGender --version 0.6.0

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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);

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
Go
Go 1.21+
インストール
go get github.com/anpekesen/namegender-go@v0.7.0

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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)

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
R
R 4.1+ · GitHub
インストール
remotes::install_github('anpekesen/namegender-r', ref = 'v0.7.0')

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
PowerShell
Windows PowerShell 5.1 · PowerShell 7 · PowerShell Gallery
インストール
Install-Module NameGender

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
$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

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス
Rust
async · reqwest + rustls · crates.io
インストール
cargo add namegender

コピーできませんでした。テキストを選択してコピーしてください。

使用方法
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")

コピーできませんでした。テキストを選択してコピーしてください。

ソース REST API リファレンス

別の言語が必要ですか？

どの言語かお知らせいただければ確認いたします。API サーフェスは十分に小さいため、コミュニティラッパーは週末の作業で済み、ここにリンクします。

サポートに問い合わせ