Dokumentacja dla deweloperów

Kredyty i ceny

DomScan API do analizy domen: DomScan daje Ci 1 000 bezpłatnych kredytów co miesiąc. Karta kredytowa nie jest wymagana.

Kredyty i ceny

DomScan daje Ci 1 000 bezpłatnych kredytów co miesiąc. Karta kredytowa nie jest wymagana.

Bezpłatne kredyty odnawiają się 1. dnia każdego miesiąca (00:00 UTC).. Potrzebujesz więcej kredytów? Wybierz opcjonalny plan miesięczny lub kup pakiet jednorazowy. Kredyty z zakupionych pakietów nie wygasają:

Kredyty na punkt końcowy

Poniżej znajdziesz koszty popularnych endpointów. Niektóre endpointy referencyjne są bezpłatne. Pełny cennik w formacie do odczytu maszynowego jest dostępny pod adresem /v1/pricing.

Punkt końcowyKredytyOpis
/v1/coverage 0 Wyświetl TLD z mapowaniami RDAP
/v1/tlds 0 Lista metadanych TLD
/v1/watchlist 1 Widok your watchlist
/v1/webhooks 2 Za każdy alert dostarczony na Twój endpoint webhooka. Nieudane dostarczenia są zwracane, a zdarzenia testowe są bezpłatne.
/v1/status 1 Sprawdzenie domain availability
/v1/health/quick 1 Szybka kontrola kondycji
/v1/dns 1 Wyszukiwanie DNS
/v1/dns/bulk 1/domain Zbiorcze zapytanie DNS (do 25 domen)
/v1/ip 1 Geolokalizacja IP
/v1/value 2 Wycena domeny
/v1/prices 0-1/pair Ceny rejestracji
/v1/tlds/:tld 1 Szczegóły TLD
/v1/watchlist/check 1 Sprawdzenie watchlist item
/v1/typos/permutations 1 Permutacje typosquattingu
/v1/typos/score 1 Wynik ryzyka typosquattingu
/v1/email/check 1 Sprawdzenie czarnej listy e-maili
/v1/status/bulk 1/domain Sprawdź dostępność wielu nazw domen jednocześnie. Obsługuje do 50 domen na żądanie.
/v1/health 3 Pełna kontrola kondycji
/v1/dns/all 2 Wszystkie DNS records
/v1/profile 3 Profil domeny
/v1/redirects 2 Łańcuch przekierowań
/v1/tech 3-9 Wykrywanie stosu technologicznego
/v1/categorize 3 Kategoryzacja witryny
/v1/similarity 2 Podobieństwo domeny
/v1/typos 2-3 Wykrywanie typosquattingu
/v1/reputation 3 Reputacja domeny
/v1/reputation/bulk 3/domain Zbiorcza reputacja domen (do 3 domen)
/v1/certificates 2 Certyfikat SSL
/v1/certificates/bulk 2/domain Certyfikat SSL
/v1/social 2 Sprawdzenie nazwy w mediach społecznościowych
/v1/social/bulk 2/handle Zbiorcze sprawdzanie nazw użytkowników w mediach społecznościowych
/v1/company 3 Wyszukiwanie firmy
/v1/suggest 2-5 Sugestie domeny
/v1/whois 3 Wyszukiwanie WHOIS
/v1/whois/history 3 Historia zmian WHOIS
/v1/whois/bulk 3/domain Masowe zapytanie WHOIS (do 20 domen)
/v1/rdap/bulk 2/query Wyszukiwanie WHOIS
/v1/prices/bulk 1/pair Zbiorcze ceny
/v1/dns/security 3 Analiza bezpieczeństwa DNS
/v1/dns/propagation 2 Propagacja DNS
/v1/dns/propagation/bulk 2/domain Propagacja DNS
/v1/email-auth/bulk 3/domain Uwierzytelnianie poczty e-mail
/v1/hosting/bulk 3/domain Wykrywanie hostingu
/v1/value/bulk 2/domain Zbiorczą wycenę
/v1/health/bulk 3/domain Zbiorczą kontrolę kondycji
/v1/subdomains 4-5 Wyszukiwarka subdomen
/v1/subdomains/bulk 4-5/domain Wyszukiwarka subdomen
/v1/report 5 Raport całościowy (zaoszczędza ~10 kredytów w porównaniu do oddzielnych wywołań)

Egzekwowanie kredytu

Kiedy Twoje środki osiągną zero, żądania API, które kosztują kredyty, zwracają HTTP 402 (wymagana płatność). Nie ma to wpływu na bezpłatne narzędzia oparte na przeglądarce.

HTTP 402 Payment Required
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits. This endpoint costs 2 credits but you have 0.",
    "credits_remaining": 0,
    "credits_required": 2,
    "purchase_url": "https://domscan.net/billing"
  }
}

Potrzebujesz więcej kredytów? Wybierz opcjonalny plan miesięczny lub kup pakiet jednorazowy. Kredyty z zakupionych pakietów nie wygasają:

Bezpłatne kredyty odnawiają się 1. dnia każdego miesiąca (00:00 UTC)..

Nagłówki odpowiedzi kredytowej

Wszystkie uwierzytelnione odpowiedzi API zawierają nagłówek X-Credits-Remaining pokazujący aktualne saldo kredytu po wysłaniu żądania.

X-Credits-Remaining: 9500

Każda uwierzytelniona odpowiedź /v1, także z błędem, zawiera te nagłówki:

  • X-Credits-Charged: kredyty pobrane za to żądanie, po odjęciu zwrotu dokonanego w tym samym żądaniu (0, gdy nic nie pobrano).
  • X-Credits-Remaining: Twoje saldo po żądaniu. Jest pomijany w rzadkim przypadku, gdy saldo nie jest jeszcze znane.
  • X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset: Twoja pojemność serii, liczba żądań, które możesz jeszcze wysłać od razu, oraz czas Unix w sekundach, kiedy pojemność zostanie w pełni odnowiona.
  • MCP przez HTTP zwraca X-Credits-Charged i X-Credits-Remaining dla wywołań narzędzi w każdym żądaniu.

Oszacuj koszt przed uruchomieniem

Wyślij metodę, ścieżkę, zapytanie i treść żądania na POST /v1/estimate, aby poznać liczbę kredytów, które by pobrało, wraz ze szczegółami i uwagami. Nic nie jest wykonywane, a szacowanie kosztuje 0 kredytów. Gdy ostateczna opłata zależy od wyniku, szacunek jest wartością maksymalną, a uwaga wyjaśnia dlaczego.

POST /v1/estimate

Treść żądania

ParametrTypOpis
method wymagane string
Dozwolone wartości GETPOSTPUTPATCHDELETE
Metoda HTTP szacowanego żądania.
path wymagane string Ścieżka szacowanego żądania, na przykład /v1/value/bulk. Query string w ścieżce jest również odczytywany.
query opcjonalne object Parametry zapytania jako obiekt. Tablice są łączone przecinkami.
body opcjonalne any Treść JSON, którą wysłałoby żądanie.

Przykładowe żądanie

curl -X POST "https://domscan.net/v1/estimate" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"method":"POST","path":"/v1/value/bulk","body":{"domains":["example.com","example.org"]}}'

Przykładowa odpowiedź

{
  "credits": 2,
  "breakdown": [
    { "component": "domains", "quantity": 2, "unit_credits": 1, "credits": 2 }
  ],
  "notes": ["Żądania odrzucone ze statusem 4xx lub zakończone błędem ze statusem 5xx są zwracane automatycznie."],
  "maximum": false,
  "rejected": false
}

Pola odpowiedzi

Pole Typ
credits integer
breakdown[] object[]
breakdown[] object
breakdown[].component string
breakdown[].quantity integer
breakdown[].unit_credits number
breakdown[].credits integer
notes[] string[]
maximum boolean
rejected boolean
billing_model string
endpoint object
endpoint.method string
endpoint.path string
dry_run boolean

Endpointy bulk, compare, recipe i pricing akceptują także dry_run=true. Żądanie otrzymuje odpowiedź HTTP 200 z tym samym szacunkiem oraz "dry_run": true, bez wykonania i bez pobierania kredytów.

Wyślij opinię

Zgłoś błąd, nieprawidłowe lub brakujące dane, brakującą funkcję albo problem z dokumentacją, lub napisz, co działa dobrze. Pełna wiadomość trafia od razu do zespołu DomScan wraz z Twoim kontem. Wysyłanie opinii jest bezpłatne, a każde konto może wysłać do 10 wiadomości na godzinę. Agenci AI mogą korzystać z narzędzia MCP send_feedback.

POST /v1/feedback

Treść żądania

ParametrTypOpis
message wymagane string Opinia prostymi słowami, do 3000 znaków. Napisz, czego oczekiwałeś i co się stało. Klucze API i bearer tokeny są usuwane przed wysłaniem wiadomości.
category opcjonalne string
Dozwolone wartości bugfeature_requestdata_qualitydocspraiseother
Czego dotyczy opinia. Wartość domyślna to other.
tool opcjonalne string Narzędzie MCP lub ścieżka API, której dotyczy opinia, do 120 znaków.

Przykładowe żądanie

curl -X POST "https://domscan.net/v1/feedback" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"message":"WHOIS for example.io returns no registrar.","category":"data_quality","tool":"/v1/whois"}'

Przykładowa odpowiedź

{
  "received": true,
  "feedback_id": "fbk_3f2c9a1b7d8e4f60a1b2c3d4e5f60718",
  "category": "data_quality"
}

Pola odpowiedzi

Pole Typ
received boolean
feedback_id string
category string

Kalkulator kredytów

Oszacuj zużycie kredytów dla operacji zbiorczych:

Wymagane kredyty razem
100
To 1.0% Twoich bezpłatnych miesięcznych środków

Pakiety kredytów

Potrzebujesz więcej kredytów? Wybierz opcjonalny plan miesięczny lub kup pakiet jednorazowy. Kredyty z zakupionych pakietów nie wygasają:

PakietCenaZa kredyt
10 000 kredytow$10.00 / €10.00 / £8.00 / ¥1,700$0.00100
50 000 kredytow$30.00 / €28.00 / £24.00 / ¥5,000$0.00060
250 000 kredytow$85.00 / €80.00 / £67.00 / ¥14,000$0.00034
1 000 000 kredytow$269.00 / €255.00 / £210.00 / ¥45,000$0.00027

Plany miesięczne

Plany miesięczne są opcjonalne i zaczynają się dopiero wtedy, gdy któryś wybierzesz. Nigdy nie przenosimy Cię na płatny plan ani nie obciążamy Cię bez pytania. Płatny plan zastępuje Twoje bezpłatne kredyty, dopóki jest aktywny. Kredyty z planu odnawiają się w każdym okresie rozliczeniowym; niewykorzystane kredyty wygasają z końcem okresu i nie przechodzą na kolejny.

  • Starter: 25 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $6.00 / Miesięczna opłata wynosi €6.00 / Miesięczna opłata wynosi £5.00 / Miesięczna opłata wynosi ¥1,000
  • Pro: 100 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $19.00 / Miesięczna opłata wynosi €18.00 / Miesięczna opłata wynosi £15.00 / Miesięczna opłata wynosi ¥3,200
  • Scale: 500 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $49.00 / Miesięczna opłata wynosi €46.00 / Miesięczna opłata wynosi £39.00 / Miesięczna opłata wynosi ¥8,100
  • Scale 1M: 1 000 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $95.00 / Miesięczna opłata wynosi €89.00 / Miesięczna opłata wynosi £74.00 / Miesięczna opłata wynosi ¥16,000
  • Scale 3M: 3 000 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $279.00 / Miesięczna opłata wynosi €260.00 / Miesięczna opłata wynosi £220.00 / Miesięczna opłata wynosi ¥46,000
  • Scale 10M: 10 000 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $915.00 / Miesięczna opłata wynosi €855.00 / Miesięczna opłata wynosi £715.00 / Miesięczna opłata wynosi ¥151,000
  • Scale 25M: 25 000 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $2,240.00 / Miesięczna opłata wynosi €2,090.00 / Miesięczna opłata wynosi £1,740.00 / Miesięczna opłata wynosi ¥369,000
  • Scale 50M: 50 000 000 kredytów na okres rozliczeniowy, Miesięczna opłata wynosi $4,390.00 / Miesięczna opłata wynosi €4,090.00 / Miesięczna opłata wynosi £3,410.00 / Miesięczna opłata wynosi ¥723,000