Określ płeć na podstawie maksymalnie 50 nazw użytkowników

Podsumowanie żądania w dużych ilościach

Przetwarzanie maksymalnie 50 nazw użytkowników

Wyślijdatatablicę. GenderAPI analizuje potencjalne sygnały imiennne z każdego handle'a i zwraca wyniki z Twojego opcjonalnego rekorduid.

MethodPOST

Maximum50 nazw użytkowników

AuthenticationToken Bearer

Opcje AINie obsługiwane

Wyniki dla wielu nazw użytkowników wymagają ostrożnego przeglądu.

Handle'y mogą zawierać marki, terminy fantasy lub niepowiązane słowa. Wielokrotne żądania nie są akceptowaneaskToAI or forceToGenderize. Aby zapewnić wyższy poziom pewności w przypadku niezwykłych danych wejściowych, użyjjednego żądania.

HDR

Wymagane nagłówki HTTP

Oprawienie żądania w formie grupowego

Content-Typeapplication/json

AuthorizationBearer TWOJ_KLUCZ_API

Ciało żądania w formacie JSON

Parametry

Field	Type	Requirement	Description
`data`	object[]	Wymagane	Array zawierający od 1 do 50 rekordów nazw użytkowników.
`data[].username`	string	Wymagane	Nazwa użytkownika lub handle do analizy; obsługiwane są podkreślenia i liczby.
`data[].country`	string	Opcjonalne	Kod kraju ISO 3166-1 alpha-2 używany jako kontekst regionalny.
`data[].id`	string \| integer	Opcjonalne	Twoje identyfikatory, zwrócone bez zmian wraz z odpowiadającym wynikiem.

Wskazówki dotyczące danych wejściowych

Nazwy użytkowników z literami łacińskimi zwykle przekazują bardziej jasne informacje o imieniu. Używaj unikalnych wartości i ocenij wyodrębnioneiddane przed aktualizacją rekordów.name and probabilityTwórz tablicę nazw użytkowników

Zawartość żądania

Twórz tablicę nazw użytkowników

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Przykłady kodu

Wyślij żądanie z wieloma nazwami użytkowników

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Odpowiedź 200

Wyodrębnione imiona i przewidywania

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

Pola odpowiedzi

Field	Type	Description
`status`	boolean	Czy żądanie w dużych ilościach zakończyło się powodzeniem.
`used_credits`	integer	Kredyty zużyte w ramach podanych nazw użytkowników.
`remaining_credits`	integer	Kredyty dostępne po wykonaniu żądania.
`expires`	integer	Czas wygaśnięcia pakietu w formie czasu UNIX.
`names`	object[]	Wyniki dla podanych nazw użytkowników.
`names[].name`	string	Potencjalna nazwa wyodrębniona z nazwy użytkownika.
`names[].q`	string	Oryginalna nazwa użytkownika podana w żądaniu.
`names[].gender`	string \| null	Przewidywana wartość: męski, żeński lub null.
`names[].country`	string	Kod krajowy uznany dla tego wyniku.
`names[].total_names`	integer	Liczba próbek wspierających ten wynik.
`names[].probability`	integer	Poziom pewności przewidywania w procentach.
`names[].id`	string \| integer	Identyfikator wejściowy zwrócony do powiązania z rekordem.
`duration`	string	Całkowity czas przetwarzania serwera.

Zachowaj każdy żądanie w zakresie 50 rekordów

Podziel większe dane na bloki. Imię to sygnał pośredni, dlatego zweryfikuj wyodrębnione imię i ustal odpowiedni próg prawdopodobieństwa przed stosowaniem wyników.

Następny odniesienie

Waliduj i formatuj numery telefonu

Walidacja numerów telefonuPrzegląd metod walidacji i formatowania →Username jednego żądaniaUse Opcje AI for one handle →