# Gender API nimille, sähköpostiosoitteille ja käyttäjänimille

> 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.

Canonical HTML: https://www.genderapi.io/fi

Last reviewed: 2026-09-30

## Yleiskatsaus

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.

## Kokeile V2-pyyntöä nimellä

Jokainen pyyntö maksaa 1 krediitin. Jos API-avainta ei ole tallennettu tai sitä ei tunnisteta, käytetään IP-kokeilua: 10 krediittiä 24 tunnin välein, yhteisesti kaikille saman IP-osoitteen käyttäjille.

Todellinen V2-vastaus, haettu 1.10.2026. Lähetä pyyntö, niin näet ajantasaisen tuloksen.

**Esimerkkivastaus; ei reaaliaikaisen pyynnön tulos**

```json
{
  "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
    }
  }
}
```

- [Avaa reaaliaikainen demo HTML-sivulla](https://www.genderapi.io/fi#name-demo)

## Gender API nimille eri puolilta maailmaa

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.

Kattavuus riippuu nimestä ja maasta: Koko maailma

Luottamusarvo, lähde ja tulkinta: 0–1

Tulos ja käytetyt krediitit JSON-muodossa: V2

Kohdetta eräpyynnössä API-avaimella; IP-kokeilussa 10: 50

## Arvioi sukupuoli etunimen tai koko nimen perusteella

Saat ennusteen, luottamusarvon ja ennusteen lähteen. Jos ennustetta ei voida muodostaa, V2 merkitsee tuloksen selvästi tuntemattomaksi.

- Etunimet ja koko nimet

- Valinnainen maakonteksti, kun maa tiedetään

- Latinalaiset ja muut kirjoitusjärjestelmät

- [Katso V2-pyynnöt nimille →](https://www.genderapi.io/fi/docs/v2/gender-from-name)

## Hyödynnä sähköpostiosoitteen nimisignaali

Tunnista nimisignaali tavallisista sähköpostiosoitteiden muodoista ja täydennä CRM-, liidi- tai analytiikkadataa ennusteella ja sen lähteellä.

- Henkilökohtaiset ja työsähköpostiosoitteet

- CRM-tietueiden rikastus

- Luottamusarvo ja lähde vastauksessa

- [Katso V2-pyynnöt sähköpostiosoitteille →](https://www.genderapi.io/fi/docs/v2/gender-from-email)

## Analysoi käyttäjänimiä ja lempinimiä

Tunnista tutut nimet käyttäjänimistä. forceToGenderize-asetuksella voit pyytää ennustetta myös lempinimelle, jossa ei ole oikeaa nimeä, mutta ennustetta ei taata.

- Sosiaalisen median ja yhteisöjen käyttäjädata

- Valinnainen lempinimianalyysi

- Selkeä tila, kun ennustetta ei ole

- [Katso V2-pyynnöt käyttäjänimille →](https://www.genderapi.io/fi/docs/v2/gender-from-username)

## Käsittele nimilistat kerralla

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.

- Excel- ja CSV-tiedostot

- Etunimi-, koko nimi- tai sähköpostisarakkeet

- Valinnainen maakonteksti

- [Lue V2:n eräpyyntöohje →](https://www.genderapi.io/fi/docs/v2/batch)

## Integroi API tai yhdistä jo käyttämäsi työkalut

Aloita REST API:lla tai yhdistä GenderAPI.io taulukoihin, verkkokauppa-alustoihin ja automaatiotyökaluihin. Jokainen ohje kertoo, mitä API-versiota integraatio käyttää.

- [Näytä kaikki integraatiot](https://www.genderapi.io/fi/integrations)

## Hyvä tietää ennen aloittamista

Lue pyyntötyypeistä, luottamusarvosta, maksuttomasta käytöstä ja krediittihinnoista. Pyyntömuodot ja koodiesimerkit löydät V2-dokumentaatiosta.

- [Näytä kaikki usein kysytyt kysymykset →](https://www.genderapi.io/fi/frequently-asked-questions)

### Mikä GenderAPI.io on?

GenderAPI.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ä.

### Milloin V2 käyttää tekoälyä?

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.

### Miten luottamusarvoa ja tuntemattomia tuloksia tulkitaan?

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.

### Montako krediittiä yksi pyyntö maksaa?

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.

### Voinko lähettää useita kohteita yhdellä pyynnöllä?

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.

### Voinko kokeilla API:a maksutta?

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.

### Toimiiko nykyinen API-avaimeni myös V2:ssa?

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ä.

## Kokeile GenderAPI.io:ta maksutta

Luo tili, testaa ensimmäiset pyyntösi 200 maksuttomalla krediitillä päivässä ja käsittele Excel- tai CSV-tiedostoja tarpeen mukaan.

- [Luo tili](https://app.genderapi.io/user/register)
- [Lue dokumentaatio](https://www.genderapi.io/fi/api-documentation)