Hent Kjønn via Brukernavn – Enkel Forespørsel

Endepunktet Hent Kjønn via Brukernavn lar deg bestemme kjønn på en person ved å analysere et brukernavn eller kallenavn. Alle parametere sendes via en POST-forespørsel som JSON. Du må autentisere forespørselen ved å bruke Bearer-token-metoden i Authorization-headeren.

Forespørsels-URL

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

Obligatoriske HTTP-headere

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Parametere i Forespørselskroppen

Parameter	Type	Påkrevd	Beskrivelse
username	String	Ja	Brukernavnet eller kallenavnet som skal analyseres. Dette kan være et brukernavn fra sosiale medier, skjermnavn eller alias. Kan inneholde ord som ikke er egentlige navn, som fantasinavn eller merkenavn.
country	String	Nei	En to-bokstavs landkode (ISO 3166-1 alpha-2) som kan forbedre treffsikkerheten i prediksjonen. Eksempel: `TR` for Tyrkia.
askToAI	Boolean	Nei	Hvis satt til `true`, vil API-et bruke en AI-modell for å fastslå kjønn dersom navnet som trekkes ut, ikke finnes i databasen.
forceToGenderize	Boolean	Nei	Hvis satt til `true`, vil API-et forsøke å gjette kjønn selv om brukernavnet ikke ser ut som et ekte personnavn, for eksempel fantasinavn eller kallenavn (f.eks. `sparkling_unicorn`).

Eksempel Forespørsler

cURL-eksempel

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

PHP cURL-eksempel

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

$data = array(
    "username" => "sparkling_unicorn",
    "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/username", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify({
    username: "sparkling_unicorn",
    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/username"

payload = {
    "username": "sparkling_unicorn",
    "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 JSON-respons

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "sparkling_unicorn",
  "name": "Sparkling",
  "gender": "female",
  "country": "US",
  "total_names": 9876,
  "probability": 92,
  "duration": "6ms"
}

Responsfelter

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)	Utløpsdato for pakken, som UNIX-tidstempel.
q	String	Ditt opprinnelige innsendte brukernavn.
name	String	Navnet som ble trukket ut fra brukernavnet.
gender	Enum[String]	Predikert kjønn. Mulige verdier: `male`, `female` eller `null`.
country	String	Landkoden som ble vurdert under prediksjonen.
total_names	Integer	Antall eksempler brukt til denne prediksjonen.
probability	Integer	Sikkerhetsgrad for prediksjonen i prosent.
duration	String	Tid brukt til å behandle forespørselen (f.eks. `6ms`).