# Dokumentasjon for GenderAPI.io V2

> Send din første forespørsel, koble til applikasjonen din og forstå resultatene. Start med et navn, en e-postadresse eller et brukernavn.

Canonical HTML: https://www.genderapi.io/nb/api-documentation

Last reviewed: 2026-09-29

## Send din første forespørsel

Send et navn, en e-postadresse eller et brukernavn og få en kjønnsprediksjon i JSON. Prøv URL-en nedenfor i nettleseren uten API-nøkkel, og velg deretter en veiledning for å koble til applikasjonen din.

Den gratis IP-prøveperioden gir 10 kreditter per IP-adresse per 24 timer og deles med V1. Dette eksemplet bruker bare datasettet og koster 1 kreditt per forespørsel, også hver gang siden lastes inn på nytt. Når du bruker din eksisterende API-nøkkel, deler V1 og V2 den samme kontosaldoen.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Emma&country=NO&ai_mode=off
```

- [Åpne GET-eksemplet (bruker 1 kreditt fra IP-prøveperioden)](https://api.genderapi.io/api/v2/gender?type=name&value=Emma&country=NO&ai_mode=off)
- [Konfigurer API-nøkkelen](https://www.genderapi.io/nb/docs/v2/authentication#environment-setup)
- [Forstå JSON-svaret](https://www.genderapi.io/nb/docs/v2/responses)

## Hva vil du gjøre?

Velg inndatatype for å se fungerende eksempler i cURL, JavaScript, Python, PHP, Java, C# og Go. Bruk veiledningene om resultater og belastning når du er klar til å håndtere ekte svar.

- [API-nøkkel og gratis IP-prøveperiode](https://www.genderapi.io/nb/docs/v2/authentication): Koble til API-nøkkelen din, eller prøv API-et gratis.
- [Forespørselsparametere](https://www.genderapi.io/nb/docs/v2/request-parameters): Velg inndatafelt, landkontekst og alternativer for forespørselen.
- [Offisielle SDK-er](https://www.genderapi.io/nb/docs/v2/sdks): Installer en offisiell klient for programmeringsspråket ditt.
- [Kjønn fra navn](https://www.genderapi.io/nb/docs/v2/gender-from-name): Slå opp et fornavn eller et fullt navn.
- [Kjønn fra e-postadresse](https://www.genderapi.io/nb/docs/v2/gender-from-email): Finn et navnesignal i en e-postadresse.
- [Kjønn fra brukernavn](https://www.genderapi.io/nb/docs/v2/gender-from-username): Bruk et brukernavn eller kallenavn som inndata.
- [Samleforespørsler (batch)](https://www.genderapi.io/nb/docs/v2/batch): Behandle opptil 50 navn, e-postadresser eller brukernavn på én gang.
- [Telefonvalidering](https://www.genderapi.io/nb/docs/v2/phone-validation): Kontroller og formater et telefonnummer.
- [Les et svar](https://www.genderapi.io/nb/docs/v2/responses): Les prediksjoner, konfidensverdier og ukjente resultater.
- [KI og kallenavn](https://www.genderapi.io/nb/docs/v2/ai-options): Velg når KI skal brukes, og hvordan kallenavn skal håndteres.
- [Kreditter og saldo](https://www.genderapi.io/nb/docs/v2/credits-and-usage): Sjekk saldoen og hva hver forespørsel koster.
- [Feil og nye forsøk](https://www.genderapi.io/nb/docs/v2/errors-and-retries): Løs feil og avgjør når du skal prøve på nytt.
- [Bytt fra V1 til V2](https://www.genderapi.io/nb/docs/v2/migration): Oppdater en eksisterende integrasjon med den samme API-nøkkelen.

## Oversikt over endepunkter

Kombiner https://api.genderapi.io med de absolutte stiene i tabellen. For eksempel: https://api.genderapi.io/api/v2/gender. Spørringsparametere i URL-en støttes bare av GET /gender. Bruk en JSON-body for POST-ruter, og ikke send V1-felt som name, email, username eller askToAI i en V2-forespørsel.

| Metode | Sti | Formål |
| --- | --- | --- |
| GET | /api/v2 | Offentlige funksjoner og gjeldende grenser; gratis. |
| GET | /api/v2/openapi.json | Kanonisk OpenAPI-kontrakt; gratis. |
| GET | /api/v2/errors | Maskinlesbar feilkatalog; gratis. |
| GET | /api/v2/usage | Gjeldende saldo for kontoen eller IP-prøveperioden; gratis. |
| GET / POST | /api/v2/gender | Ett navn, én e-postadresse eller ett brukernavn. |
| POST | /api/v2/gender/batch | En ordnet samleforespørsel med navn, e-postadresser og/eller brukernavn. |
| POST | /api/v2/phone/validate | Valider og formater et telefonnummer. |