Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.
Używany przez ludzi w niesamowitych firmach
Sygnały zaufania przed integracją
Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.
Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.
Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.
Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.
Co ta API pomaga wdrożyć
Użyj tej strony jako briefu produkcyjnego: endpointy, przykłady, kształt odpowiedzi i elementy workflow potrzebne do podłączenia DomScan do produktu.
Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.
Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.
Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.
Zasilaj agentów, dashboardy, playbooki SOAR i CRMy przez OpenAPI, SDK, Postman lub MCP.
Workflow integracji
Prosta ścieżka od pierwszego requestu do powtarzalnego użycia produkcyjnego.
Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
Używaj kodów statusu, kosztów kredytów i pól odpowiedzi do retries, logów i alertów.
Zestaw developerski
Przejdź z tej strony do dokumentacji machine-readable, kolekcji requestów, SDK lub narzędzi agentowych.
Generuj klientów lub sprawdzaj każdy kształt requestu i odpowiedzi.
Kolekcja PostmanImportuj gotowe requesty do testów manualnych i przekazania zespołowi.
SDK i CLIUżywaj utrzymywanych pakietów i workflow command-line zamiast pisać boilerplate.
Integracja MCPUdostępniaj domain intelligence agentom AI i wewnętrznym asystentom.
Mapa parametrów i odpowiedzi
Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.
Parametr
Example Odpowiedź
Kody statusu HTTP
Punkty końcowe
/v1/scrape
/v1/scrape/jobs
/v1/scrape/jobs/:job_id
/v1/scrape/jobs/:job_id/results
Wybierz poziom pobierania dla każdego URL
Kredyty zależą od wybranego trybu, a nie od statusu HTTP ani treści zwróconej przez docelową witrynę.
Standardowy
1 kredyt za URL
Jedna standardowa próba pobrania prostej strony.
Odporny
2 kredyty za URL
Jedna standardowa próba i jedno ponowienie, gdy wynik spełnia udokumentowane warunki ponowienia.
Renderowany
10 kredytów za URL
Jedna próba pobrania z renderowaniem w przeglądarce dla stron wymagających wykonania JavaScript.
Odporny renderowany
20 kredytów za URL
Jedna próba renderowania w przeglądarce i jedno ponowienie, gdy wynik spełnia udokumentowane warunki ponowienia.
Tryby odporne kosztują podaną kwotę nawet wtedy, gdy pierwsza próba się powiedzie. Obejmują jedno kwalifikujące się ponowienie, a nie nieograniczoną liczbę prób ani gwarancję, że docelowa witryna zwróci oczekiwaną treść.
Rozliczenie odzwierciedla żądaną pracę
Pomyślna operacja API oznacza, że DomScan wykonał wybrany tryb pobierania i zwrócił odpowiedź docelowej witryny.
Wynikiem nadal może być przekierowanie, błąd HTTP, zablokowana odpowiedź, strona wyzwania, pusta strona lub treść niespełniająca Twoich potrzeb. Takie wyniki po stronie docelowej są płatne i nie uprawniają do zwrotu kredytów.
Zwrot jest dostępny wyłącznie wtedy, gdy DomScan potwierdzi, że jego własna platforma nie wykonała wybranego trybu pobierania.
Renderowanie w przeglądarce nie gwarantuje pomyślnego załadowania strony, a tryby odporne nie gwarantują, że ponowienie przyniesie inny wynik.
Limity użycia dotyczące Scrape API
Te limity dotyczą wyłącznie Scrape API. Mogą obowiązywać także inne zabezpieczenia konta i platformy.
| Możliwość | Konta bezpłatne | Konta płatne |
|---|---|---|
| Dostępne tryby | Tylko standardowy | Wszystkie cztery tryby |
| Częstotliwość żądań | 5 żądań na minutę | 60 żądań na minutę |
| Równoczesne żądania standardowe lub odporne | 1 żądanie standardowe | 5 żądań |
| Równoczesne żądania renderowane | Niedostępne | 2 żądania |
| Limit dzienny | 100 żądań | Zależnie od dostępnych kredytów i limitów częstotliwości |
| Limit miesięczny | 500 żądań | Zależnie od dostępnych kredytów i limitów częstotliwości |
| Maksymalna zwracana treść | 256 KiB na żądanie | 512 KiB na żądanie |
| Asynchroniczne zadania zbiorcze | Niedostępne | Dostępne |
Gdy odpowiedź przekracza obowiązujący limit treści, API zwraca dozwoloną część i oznacza odpowiedź jako obciętą.
Przetwarzaj asynchronicznie do 100 URL
Konta płatne mogą przesłać asynchroniczne zadanie zawierające do 100 URL.
Do 5 nowych zadań zbiorczych na minutę
Do 3 aktywnych zadań na konto
Do 300 oczekujących elementów URL na konto
Do 100 URL w jednym zadaniu
Ukończone wyniki dostępne przez 24 godziny
Metadane zadania przechowywane przez 7 dni
Każdy URL jest rozliczany niezależnie według wybranego trybu.
Pobierz lub skopiuj ukończone wyniki w ciągu 24 godzin. Po tym czasie treść odpowiedzi zostanie usunięta, choć ograniczone metadane zadania pozostaną dostępne przez 7 dni.
Jasny zakres bez ukrytych opcji podwyższenia
Brak rozwiązywania CAPTCHA
Renderowanie w przeglądarce może wykonywać JavaScript strony, ale Scrape API nie rozwiązuje CAPTCHA ani nie omija wymogu logowania, płatnego dostępu, kontroli dostępu lub innych ograniczeń. CAPTCHA lub strona wyzwania zwrócona przez cel jest wynikiem po stronie docelowej i nie podlega zwrotowi.
Brak wyboru płatnego proxy
Wybierasz tryb pobierania i poziom wysiłku. Nie ma parametru wyboru płatnego proxy, dostawcy, puli ani kraju.
Dozwolone użycie
Używaj Scrape API wyłącznie do treści, do których masz prawne uprawnienie dostępu i przetwarzania. Odpowiadasz za przestrzeganie właściwych przepisów, warunków docelowej witryny, obowiązków dotyczących prywatności i wymaganych zezwoleń.
Nie używaj API do omijania uwierzytelniania, płatnego dostępu, CAPTCHA ani kontroli dostępu, ani do ataków na dane uwierzytelniające, nadużywania kont, nękania, niezgodnego z prawem nadzoru lub nielegalnego gromadzenia danych osobowych. DomScan może odrzucać żądania lub zawiesić dostęp, gdy użycie zagraża ludziom, usługom lub platformie.
Sygnały zaufania przed integracją
Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.
Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.
Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.
Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.
Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.
Kluczowe funkcje
Kredyty zależą od wybranego trybu, a nie od statusu HTTP ani treści zwróconej przez docelową witrynę.
Pomyślna operacja API oznacza, że DomScan wykonał wybrany tryb pobierania i zwrócił odpowiedź docelowej witryny.
Konta płatne mogą przesłać asynchroniczne zadanie zawierające do 100 URL.
Te limity dotyczą wyłącznie Scrape API. Mogą obowiązywać także inne zabezpieczenia konta i platformy.
Renderowanie w przeglądarce może wykonywać JavaScript strony, ale Scrape API nie rozwiązuje CAPTCHA ani nie omija wymogu logowania, płatnego dostępu, kontroli dostępu lub innych ograniczeń. CAPTCHA lub strona wyzwania zwrócona przez cel jest wynikiem po stronie docelowej i nie podlega zwrotowi.
Używaj Scrape API wyłącznie do treści, do których masz prawne uprawnienie dostępu i przetwarzania. Odpowiadasz za przestrzeganie właściwych przepisów, warunków docelowej witryny, obowiązków dotyczących prywatności i wymaganych zezwoleń.
Przykład Request
curl -X POST "https://domscan.net/v1/scrape" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/","mode":"standard","output":"markdown"}'
curl -X POST "https://domscan.net/v1/scrape" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/app","mode":"rendered","output":"html"}'
curl -X POST "https://domscan.net/v1/scrape/jobs" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-H "Idempotency-Key: docs-batch-1" \
-H "Content-Type: application/json" \
-d '{"mode":"standard","output":"text","urls":["https://example.com/page-1","https://example.com/page-2"]}'
Example Odpowiedź
{
"data": {
"url": "https://example.com/",
"final_url": "https://example.com/",
"status": 200,
"outcome": "success",
"content_type": "text/html",
"content": "<!doctype html>...",
"bytes": 1256,
"truncated": false,
"redirect_count": 0,
"attempt_count": 1,
"duration_ms": 428,
"fetched_at": "2026-08-20T10:30:00.000Z",
"headers": { "cache-control": "max-age=604800" },
"rendered": false
},
"billing": {
"credits_charged": 1,
"credits_refunded": 0,
"policy": "effort_based"
}
}
Często zadawane pytania
Jeden URL kosztuje 1, 2, 10 lub 20 kredytów zależnie od wybranego trybu. Elementy zadań zbiorczych podlegają tej samej cenie za URL.
Tak. Przekierowania, błędy HTTP, blokady, strony wyzwania, puste strony lub nieoczekiwana treść są płatne, ponieważ DomScan nadal wykonał żądaną pracę pobierania.
Zwrot jest dostępny wyłącznie po potwierdzeniu przez DomScan, że jego własna platforma nie wykonała wybranego trybu pobierania. Zachowanie docelowej witryny nie jest awarią platformy.
Nie. Tryb odporny obejmuje jedno ponowienie, gdy pierwszy wynik spełnia udokumentowane warunki ponowienia.
Nie. Wykonuje JavaScript strony, ale nie rozwiązuje CAPTCHA ani nie omija ograniczeń dostępu.
Nie. API nie udostępnia poziomów proxy, dostawców, pul ani kierowania według kraju. Wybierasz wyłącznie tryb pobierania.
Nie. Asynchroniczne zadania zbiorcze są dostępne wyłącznie dla kont płatnych. Konta bezpłatne mogą używać trybu standardowego w ramach opublikowanych limitów bezpłatnych.
Treść ukończonej odpowiedzi jest dostępna przez 24 godziny. Ograniczone metadane zadania pozostają dostępne przez 7 dni.
Narzędzia pokrewne i zasoby
Kody statusu HTTP
Dokumentujemy kody statusu HTTP, które powinien obsługiwać klient, aby można było odróżnić udane odpowiedzi, problemy z uwierzytelnianiem, kredyty, limity żądań, brakujące dane i błędy usług nadrzędnych.
Żądanie zakończone pomyślnie
Chybienie cache-only dla subdomen przyjęto do odświeżenia w tle. Nie pobieramy kredytów; ponów próbę po czasie Retry-After.
Nieprawidłowe parametry
Brakuje klucza API lub sesji albo są one nieprawidłowe.
Za mało kredytów, aby wykonać to żądanie.
Uwierzytelniono, ale brak uprawnień do użycia tej operacji lub trybu.
Dokumentujemy kody statusu HTTP, które powinien obsługiwać klient, aby można było odróżnić udane odpowiedzi, problemy z uwierzytelnianiem, kredyty, limity żądań, brakujące dane i błędy usług nadrzędnych.
Przekroczono limit żądań
Usługa nadrzędna jest niedostępna lub tymczasowo ogranicza żądania.
Uzyskaj klucz API