# Domain search via API

_2026-02-10_

> Web-haku valehtelee domainien saatavuudesta. Vain rekisterinpitäjän API antaa tarkat tiedot. Esimerkki Porkbunista.

Web-haku valehtelee verkkotunnusten saatavuudesta. Vain rekisterinpitäjän API antaa tarkat tiedot. Esimerkki Porkbunilla.

## Miksi ei web-haku

Hakukoneet näyttävät vanhentuneita tietoja WHOIS-välimuistista. Verkkotunnus voi olla:

- Näytetty "vapaana" — vaikka todellisuudessa varattu
- Näytetty "varattuna" — vaikka jo lunastusjaksossa (redemption period)

## Porkbun API

```
curl -X POST "https://api.porkbun.com/api/json/v3/domain/checkDomain/example.com" \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "pk1_xxx",
    "secretapikey": "sk1_xxx"
  }'
```

## Vastaus

```
{
  "status": "SUCCESS",
  "available": true,
  "pricing": {
    "registration": "8.88",
    "renewal": "8.88"
  }
}
```

## Rajoitusnopeus

> 1 pyyntö 10 sekunnissa. Massatarkistuksessa — sleep-komento pyyntöjen välissä.

## Verkkotunnustemput

Käytä ylätason verkkotunnusta (TLD) osana sanaa:

- `cataly.st` — catalyst
- `emerge.st` — emergent
- `analy.st` — analyst

— Liza #c533