GenderAPI.io · REST API v2
Arvioi todennäköinen sukupuoli etunimen, koko nimen, sähköpostiosoitteen tai käyttäjänimen perusteella. GenderAPI.io V2 palauttaa rakenteisen JSON-vastauksen, jossa on ennusteen lähde, luottamusarvo ja valinnainen maakonteksti.
GenderAPI.io V2
https://api.genderapi.io/api/v2/gender?type=name&value=AinoTodellinen V2-vastaus, haettu 1.10.2026. Lähetä pyyntö, niin näet ajantasaisen tuloksen.
| Nimi | Aino |
|---|---|
| Sukupuoli | Nainen |
| Luotettavuus | 97,1 % |
| Maa | Suomi (FI) |
| Lähde | Nimitietokanta |
| Käytetyt krediitit | 1 |
{
"data": {
"input": {
"type": "name",
"value": "Aino",
"country": null
},
"name": "aino",
"gender": "female",
"country": "FI",
"confidence": 0.9706744868035191,
"confidence_kind": "observed_frequency",
"sample_count": 341,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "aino",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "97b60fe5-6033-4720-b17f-83af3533e12b",
"duration_ms": 10,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 1,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}Etunimien ja koko nimien analyysi
Tarkista yksittäisiä kohteita, lähetä eräpyyntöjä tai käytä taulukkotyökalujamme. V2 erottaa tulokset, joissa on ennuste, tuloksista, joissa ennustetta ei ole, joten sovelluksesi voi säilyttää epävarmuuden arvaamisen sijaan.
Sukupuoli nimestä
Saat ennusteen, luottamusarvon ja ennusteen lähteen. Jos ennustetta ei voida muodostaa, V2 merkitsee tuloksen selvästi tuntemattomaksi.
Sukupuoli sähköpostista
Tunnista nimisignaali tavallisista sähköpostiosoitteiden muodoista ja täydennä CRM-, liidi- tai analytiikkadataa ennusteella ja sen lähteellä.
Sukupuoli käyttäjänimestä
Tunnista tutut nimet käyttäjänimistä. forceToGenderize-asetuksella voit pyytää ennustetta myös lempinimelle, jossa ei ole oikeaa nimeä, mutta ennustetta ei taata.
Excel- ja CSV-tiedostojen käsittely
Lataa Excel- tai CSV-tiedosto, valitse lähdesarake ja lataa tulokset. Jos lähetät eräpyyntöjä omasta sovelluksestasi, käytä V2:n eräpyyntöohjetta.
GenderAPI.io-integraatiot
Aloita REST API:lla tai yhdistä GenderAPI.io taulukoihin, verkkokauppa-alustoihin ja automaatiotyökaluihin. Jokainen ohje kertoo, mitä API-versiota integraatio käyttää.
Usein kysyttyä
Lue pyyntötyypeistä, luottamusarvosta, maksuttomasta käytöstä ja krediittihinnoista. Pyyntömuodot ja koodiesimerkit löydät V2-dokumentaatiosta.
Näytä kaikki usein kysytyt kysymyksetGenderAPI.io arvioi todennäköisen sukupuolen nimen, sähköpostiosoitteen tai käyttäjänimen perusteella. V2 palauttaa JSON-muodossa ennusteen, luottamusarvon, lähteen ja käytetyt krediitit. Ennusteet perustuvat nimissä esiintyviin säännönmukaisuuksiin; ne eivät vahvista henkilön itse ilmoittamaa sukupuoli-identiteettiä.
Yksittäinen pyyntö hakee ensin tietoaineistosta. Jos tietoaineisto ei tuota ennustetta, tekoälyä käytetään oletuksena. Tämän oletustilan hinta on yhteensä 1 krediitti, tekoäly mukaan lukien. Eräpyynnöissä tekoäly on oletuksena pois käytöstä. Voit valita tekoälytilan tai ottaa forceToGenderize-asetuksen käyttöön lempinimianalyysia varten.
V2:ssa confidence-kenttä sisältää arvon väliltä 0–1 tai null. confidence_kind erottaa tietoaineistossa havaitun esiintymistiheyden ja mallin ilmoittaman arvon; luottamusarvo ei takaa, että tulos on oikea. Jos ennustetta ei ole, vastaus sisältää gender: null ja result_status: unknown.
Tavallinen V2-pyyntö maksaa 1 krediitin, myös silloin, kun tekoälyä käytetään tai onnistuneesti käsitelty tulos jää ilman ennustetta. Tekoälytila always maksaa 2 krediittiä. forceToGenderize-asetuksella tietoaineistosta saatu ennuste maksaa 1 krediitin; jos tekoälyä tarvitaan, hinta on yhteensä 2 krediittiä. Eräpyynnöt veloitetaan kohdekohtaisesti.
Kyllä. V2 hyväksyy eräpyynnössä enintään 50 kohdetta voimassa olevalla API-avaimella tai enintään 10 kohdetta IP-kokeilussa. Yksi HTTP-pyyntö voi siis kuluttaa useita krediittejä. Suuria tiedostoja voit käsitellä myös Excel- ja CSV-työkaluilla tai muiden integraatioiden avulla.
Ilman API-avainta V2-demo käyttää IP-kokeilua, jossa on 10 krediittiä 24 tunnin välein; saldo on yhteinen kaikille saman IP-osoitteen käyttäjille. Maksuton tili saa 200 krediittiä päivässä. Kyse on krediittirajoista, ei kiinteästä pyyntömäärästä: 2 krediitin tilat kuluttavat saldoa nopeammin.
Kyllä. V1 ja V2 käyttävät samaa API-avainta ja samaa tilin saldoa. Nykyiset V1-integraatiot toimivat edelleen. Rakenna uudet integraatiot V2-dokumentaation mukaan, koska endpointit, vastauskentät ja virhemuoto poikkeavat V1:stä.
Aloita kehittäminen
Luo tili, testaa ensimmäiset pyyntösi 200 maksuttomalla krediitillä päivässä ja käsittele Excel- tai CSV-tiedostoja tarpeen mukaan.