Hent Kjønn via Navn – Enkeltforespørsel

Endepunktet Get Gender by Name lar deg bestemme kjønn basert på ett enkelt fornavn. Alle parametere sendes via en POST-forespørsel som JSON. Du må autentisere deg med Bearer-token-metoden i Authorization-headeren.

Forespørsels-URL

POST https://api.genderapi.io/api

Nødvendige HTTP-headere

  • Content-Type: application/json
  • Authorization: Bearer YOUR_API_KEY

Parametere i Forespørselsbody

Parameter Type Påkrevd Beskrivelse
name String Ja Fornavnet du ønsker å analysere. Må være ett enkelt ord uten titler eller prefikser.
country String Nei En tobokstavs landskode (ISO 3166-1 alpha-2) som kan forbedre nøyaktigheten. Eksempel: TR for Tyrkia.
askToAI Boolean Nei Hvis satt til true, vil API-et spørre en AI-modell for å avgjøre kjønn dersom navnet ikke finnes i databasen.
forceToGenderize Boolean Nei Hvis satt til true, vil API-et forsøke å gjette kjønn selv for input som ikke er vanlige menneskenavn, som kallenavn eller fantasinavn (f.eks. sparkling unicorn).

Eksempler på Forespørsler


cURL-eksempel

curl -X POST "https://api.genderapi.io/api" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -d '{"name": "Alice", "country": "US", "askToAI": true, "forceToGenderize": true}'

PHP cURL-eksempel

<?php
$url = "https://api.genderapi.io/api";

$data = array(
    "name" => "Alice",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

JavaScript fetch-eksempel

fetch("https://api.genderapi.io/api", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    name: "Alice",
    country: "US",
    askToAI: true,
    forceToGenderize: true
  })
})
.then(response => response.json())
.then(data => console.log(data));

Python requests-eksempel


import requests

url = "https://api.genderapi.io/api"

payload = {
    "name": "Alice",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Eksempel på JSON-svar

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "Alice",
  "name": "Alice",
  "gender": "female",
  "country": "US",
  "total_names": 10234,
  "probability": 98,
  "duration": "4ms"
}

Felter i Svar

Felt Type Beskrivelse
status Boolean Indikerer om forespørselen var vellykket.
used_credits Integer Antall kreditter brukt for denne forespørselen.
remaining_credits Integer Kreditter som gjenstår på kontoen din etter forespørselen.
expires Integer (timestamp) Dato for når pakken utløper, som UNIX-timestamp.
q String Din innsendte forespørsel (navnet du sendte inn).
name String Navnet som ble analysert eller hentet ut.
gender Enum[String] Predikert kjønn. Mulige verdier: male, female eller null.
country String Landskoden som ble tatt hensyn til under prediksjonen.
total_names Integer Antall navneprøver brukt for denne prediksjonen.
probability Integer Sannsynlighetsprosent for kjønnsprediksjonen.
duration String Tiden brukt på å behandle forespørselen (f.eks. 4ms).
Advarsel: Sørg alltid for at inndata som navn ikke inneholder uventede tegn. Hvis du planlegger å bruke spesialtegn eller mellomrom, må du sikre korrekt JSON-koding for å unngå feil.