Dane internetowe 4 Punkty końcowe 6 Kluczowe funkcje

API: Scraping stron internetowych

Wyślij URL, wybierz wymagany poziom pobierania i odbierz odpowiedź strony przez jedno API. Do prostych stron używaj lekkich żądań, trybów odpornych, gdy ponowienie może pomóc, albo renderowania w przeglądarce dla treści tworzonych przez JavaScript.

Kategoria Dane internetowe
Punkty końcowe 4
Kluczowe funkcje 6
Często zadawane pytania 8

Używany przez ludzi w niesamowitych firmach

VercelLLM PulseOLXCasa ModernaPipeCal.comBeehiivSnykTogglRemoteSprigDeel

Sygnały zaufania przed integracją

Przejrzysta dokumentacja, uwierzytelnione żądania i widoczne informacje o niezawodności ułatwiają ocenę DomScan przed wdrożeniem.

Aktywna Status usługi

Przed integracją sprawdź bieżący stan usługi i udokumentowane odpowiedzi na błędy.

OpenAPI Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

10,000 Darmowy limit

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.

Workflow produktu

Osadzaj sprawdzanie domen, DNS intelligence, sygnały ryzyka lub enrichment w onboardingu, wyszukiwarce i narzędziach wewnętrznych.

Automatyzacja analityków

Zastąp powtarzalne ręczne lookupy zadaniami cyklicznymi, alertami i odtwarzalnymi krokami dochodzenia.

Czyste dane JSON

Używaj przewidywalnych pól, udokumentowanych kodów statusu i kosztów kredytów zamiast scrapować strony dostawców.

AI i narzędzia ops

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.

1
Uwierzytelnij raz

Wyślij klucz API w udokumentowanym nagłówku i utrzymuj spójne requesty między usługami.

2
Odpytuj z przykładami

Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.

3
Operuj i monitoruj

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.

Mapa parametrów i odpowiedzi

Przejrzyj inputy, pola outputu i kody statusu przed podłączeniem endpointu do klienta.

Parametry requestu

Parametr

urlmodeoutputurlsjob_idlimitoffset
Pola odpowiedzi

Example Odpowiedź

datadata.urldata.final_urldata.statusdata.outcomedata.content_typedata.contentdata.bytesdata.truncateddata.redirect_countdata.attempt_countdata.duration_ms
Zakres statusów

Kody statusu HTTP

200202400401402403409429503

Punkty końcowe

POST /v1/scrape
Kredyty: 1-20/itemUwierzytelnianie: Uwierzytelnienie required
urlmodeoutput
POST /v1/scrape/jobs
Kredyty: 1-20/itemUwierzytelnianie: Uwierzytelnienie required
modeoutputurls
GET /v1/scrape/jobs/:job_id
Kredyty: 0Uwierzytelnianie: Uwierzytelnienie required
job_id
GET /v1/scrape/jobs/:job_id/results
Kredyty: 0Uwierzytelnianie: Uwierzytelnienie required
job_idlimitoffset

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.

Status usługi Materiały API

Linki OpenAPI, Swagger, Postman, CLI, SDK i MCP są dostępne jednym kliknięciem.

Klucze API Chroniony dostęp

Uwierzytelnione endpointy używają kluczy API z jasnymi kosztami kredytów przed wywołaniem.

Darmowy limit Zarejestruj się Bezpłatnie

Zacznij od 10 000 kredytów miesięcznie i przejdź wyżej dopiero, gdy użycie wzrośnie.

Aktywny Przykład Request

Zacznij od przykładów curl i HTTP, potem zmapuj parametry w kodzie aplikacji.

Kluczowe funkcje

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ę.

Rozliczenie odzwierciedla żądaną pracę

Pomyślna operacja API oznacza, że DomScan wykonał wybrany tryb pobierania i zwrócił odpowiedź docelowej witryny.

Przetwarzaj asynchronicznie do 100 URL

Konta płatne mogą przesłać asynchroniczne zadanie zawierające do 100 URL.

Limity użycia dotyczące Scrape API

Te limity dotyczą wyłącznie Scrape API. Mogą obowiązywać także inne zabezpieczenia konta i platformy.

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.

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ń.

Przykład Request

Żądanie standardowe bash
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"}'
Żądanie renderowane w przeglądarce bash
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"}'
Asynchroniczne żądanie zbiorcze bash
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ź

Pomyślna odpowiedź standardowa json
{
  "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

Ile kredytów kosztuje jeden URL?

Jeden URL kosztuje 1, 2, 10 lub 20 kredytów zależnie od wybranego trybu. Elementy zadań zbiorczych podlegają tej samej cenie za URL.

Czy zostanie naliczona opłata, jeśli cel zwróci błąd lub stronę blokady?

Tak. Przekierowania, błędy HTTP, blokady, strony wyzwania, puste strony lub nieoczekiwana treść są płatne, ponieważ DomScan nadal wykonał żądaną pracę pobierania.

Kiedy żądanie podlega zwrotowi?

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.

Czy tryb odporny ponawia próbę, dopóki strona nie zadziała?

Nie. Tryb odporny obejmuje jedno ponowienie, gdy pierwszy wynik spełnia udokumentowane warunki ponowienia.

Czy renderowanie w przeglądarce rozwiązuje CAPTCHA?

Nie. Wykonuje JavaScript strony, ale nie rozwiązuje CAPTCHA ani nie omija ograniczeń dostępu.

Czy mogę wybrać płatne proxy lub kraj?

Nie. API nie udostępnia poziomów proxy, dostawców, pul ani kierowania według kraju. Wybierasz wyłącznie tryb pobierania.

Czy konta bezpłatne mogą wysyłać zadania zbiorcze?

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.

Jak długo przechowywane są wyniki zadań zbiorczych?

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.

OK 200

Żądanie zakończone pomyślnie

Przyjęto 202

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 żądanie 400

Nieprawidłowe parametry

Nieautoryzowany 401

Brakuje klucza API lub sesji albo są one nieprawidłowe.

Wymagana płatność 402

Za mało kredytów, aby wykonać to żądanie.

Zabronione 403

Uwierzytelniono, ale brak uprawnień do użycia tej operacji lub trybu.

HTTP 409 409

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.

Zbyt wiele żądań 429

Przekroczono limit żądań

Usługa niedostępna 503

Usługa nadrzędna jest niedostępna lub tymczasowo ogranicza żądania.

Uzyskaj klucz API