API domen .pl dla portfeli domen
API Domaining udostępnia wycenę domen .pl i dane Twoich ofert na giełdzie, te same, które widzisz w panelu. To interfejs REST z odpowiedziami w JSON, dostępny w Narzędziach Pro od planu Portfolio. Klucz API generujesz w panelu, w zakładce Ustawienia.
Co udostępnia API domen .pl
| Zasób | Metoda | Opis |
|---|---|---|
| /api/v1/wycena | GET | Ocena od 0 do 100, przedział wartości orientacyjnej i rozbicie oceny na cechy dla jednej nazwy .pl. |
| /api/v1/oferty | GET | Twoje oferty na giełdzie: domena, rodzaj oferty, cena, status, data wystawienia i liczba zapytań. |
Zapytanie o wycenę
Każde zapytanie uwierzytelniasz kluczem API z panelu w nagłówku Authorization. Nazwę podajesz w parametrze domena, a kategorię w parametrze kategoria: finanse, ecommerce, medycyna, nieruchomosci, lokalne albo dowolna.
curl "https://domaining.pl/api/v1/wycena?domena=twojafirma.pl&kategoria=finanse" \
-H "Authorization: Bearer TWOJ_KLUCZ"Odpowiedź zawiera ocenę, dolną i górną granicę wartości orientacyjnej oraz rozbicie oceny na cechy nazwy. Każda wycena przez API liczy się do miesięcznego limitu wycen Twojego planu.
Limity API
- Plan Portfolio: 10 000 zapytań dziennie.
- Plan Firma: 25 000 zapytań dziennie.
- Wyceny przez API mieszczą się w miesięcznym limicie wycen planu: 20 000 w planie Portfolio i 50 000 w planie Firma.
- Po przekroczeniu limitu API odpowiada kodem 429 z opisem, który limit został wykorzystany.
Porównanie planów znajdziesz w cenniku Domaining.
Jak dostać klucz API
Klucz generujesz w panelu, w zakładce Ustawienia, gdy konto ma plan Portfolio albo Firma. Klucz pokazujemy tylko raz, przy wygenerowaniu, a u siebie przechowujemy wyłącznie jego skrót. Jeśli klucz wycieknie, generujesz nowy, a poprzedni przestaje działać. Zapytanie z błędnym kluczem albo z konta bez API dostaje odpowiedź 401.
Do czego domainerzy używają API
- Własne arkusze i systemy analityczne zasilane wyceną nazw z portfela.
- Masowa wycena domeny dla list, które trzymasz poza panelem.
- Zestawienie stanu Twoich ofert na giełdzie domen we własnym raporcie sprzedaży.
- Sprawdzanie oceny nazwy przed decyzją, czy ją odnowić, czy wystawić na sprzedaż.
Pytania o API
W jakim formacie są dane?
W JSON, z datami w formacie ISO 8601. Błędy mają pole blad z opisem po polsku i odpowiedni kod HTTP.
Od jakiego planu jest API?
Od planu Portfolio, 1 990 zł netto miesięcznie, z limitem 10 000 zapytań dziennie. Plan Firma ma limit 25 000 zapytań dziennie.
Czy wycena przez API zużywa limit wycen?
Tak. Każda wycena przez API liczy się do miesięcznego limitu wycen planu, tak samo jak wycena w panelu.
Podłącz swój portfel przez API
Wybierz plan Portfolio albo Firma i wygeneruj klucz API w panelu, w zakładce Ustawienia.