Oversikt over masseoppslag
Behandle opptil 50 brukernavn
Send en data-liste. GenderAPI henter ut mulige navnesignaler fra hvert brukernavn og returnerer resultatene sammen med din valgfrie id for sikker kobling av poster.
Brukernavn kan inneholde merkenavn, fantasiord eller andre uttrykk uten personnavn. Masseforespørsler godtar ikke askToAI or forceToGenderize. For mer kontroll ved uvanlige inndata bruker du enkeltforespørselen.
Påkrevde HTTP-headere
Autoriser masseforespørselen
Content-Typeapplication/jsonAuthorizationBearer YOUR_API_KEYJSON-forespørsel
Parametere
| Felt | Type | Krav | Beskrivelse |
|---|---|---|---|
data | object[] | Påkrevd | Liste med mellom 1 og 50 brukernavnsposter. |
data[].username | string | Påkrevd | Brukernavn eller profilnavn som skal analyseres; understrek og tall støttes. |
data[].country | string | Valgfritt | ISO 3166-1 alfa-2-landkode som brukes som regional kontekst. |
data[].id | string | integer | Valgfritt | Din identifikator, returnert uendret med det tilhørende resultatet. |
Brukernavn med latinske tegn gir vanligvis tydeligere navnesignaler. Bruk unike id-verdier, og vurder både uttrukket name og probability før du oppdaterer poster.
Forespørselsdata
Bygg listen med brukernavn
{
"data": [
{ "username": "anna_smith88", "country": "US", "id": "123" },
{ "username": "michael_bauer", "country": "DE", "id": "456" },
{ "username": "giulia_rossi", "country": "IT", "id": "789" }
]
}Kodeeksempler
Send en forespørsel med flere brukernavn
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"}]}'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 })
});200-svar
Uttrukne navn og prediksjoner
{
"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"
}Svarfelter
| Felt | Type | Beskrivelse |
|---|---|---|
status | boolean | Om masseforespørselen ble fullført. |
used_credits | integer | Antall kreditter brukt for de innsendte brukernavnene. |
remaining_credits | integer | Tilgjengelige kreditter etter forespørselen. |
expires | integer | Pakkens utløpstid som UNIX-tidsstempel. |
names | object[] | Resultater for de innsendte brukernavnene. |
names[].name | string | Mulig navn hentet ut fra brukernavnet. |
names[].q | string | Det opprinnelige brukernavnet i forespørselen. |
names[].gender | string | null | Predikert verdi: male, female eller null. |
names[].country | string | Landkoden som ble brukt for resultatet. |
names[].total_names | integer | Antall datapunkter som støtter resultatet. |
names[].probability | integer | Prediksjonens konfidens i prosent. |
names[].id | string | integer | Identifikatoren fra inndata, returnert for kobling av poster. |
duration | string | Samlet behandlingstid på serveren. |
Begrens hver forespørsel til 50 poster
Del større datamengder i flere grupper. Et brukernavn er et indirekte signal, så kontroller navnet som er hentet ut, og fastsett en akseptabel sannsynlighetsterskel før resultatene tas i bruk.
Neste referanse