통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
놀라운 회사의 사람들이 사용함
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
이 API로 만들 수 있는 것
이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.
도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.
반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.
제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.
OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.
통합 워크플로
첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.
문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.
개발자 키트
이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.
매개변수 및 응답 맵
엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.
매개변수
예제 응답
HTTP 상태 코드
엔드포인트
/v1/scrape
/v1/scrape/jobs
/v1/scrape/jobs/:job_id
/v1/scrape/jobs/:job_id/results
각 URL에 대해 검색 노력을 선택합니다
크레딧은 대상 웹사이트에서 반환된 HTTP 상태 또는 콘텐츠가 아니라 요청한 모드에 따라 결정됩니다.
표준
URL당 1 크레딧
간단한 페이지를 위한 하나의 표준 검색 시도입니다.
복원력 있는
URL당 2 크레딧
결과가 문서화된 재시도 조건을 충족할 때 하나의 재시도가 있는 하나의 표준 시도입니다.
렌더링됨
URL당 10 크레딧
JavaScript 실행이 필요한 페이지를 위한 하나의 브라우저 렌더링 시도입니다.
렌더링된 복원력 있는
URL당 20 크레딧
결과가 문서화된 재시도 조건을 충족할 때 하나의 재시도가 있는 하나의 브라우저 렌더링 시도입니다.
복원력 있는 모드는 첫 번째 시도가 성공해도 나열된 금액이 소요됩니다. 여기에는 하나의 적격 재시도가 포함되며, 무제한 재시도나 대상 웹사이트가 예상하는 콘텐츠를 반환할 것이라는 보장이 아닙니다.
청구는 요청된 작업을 반영합니다
성공적인 API 작업은 DomScan이 선택한 검색 모드를 수행하고 결과 대상 응답을 반환했음을 의미합니다.
결과는 여전히 리디렉션, HTTP 오류, 차단된 응답, 챌린지 페이지, 빈 페이지 또는 요구 사항을 충족하지 않는 콘텐츠일 수 있습니다. 이러한 대상 사이트 결과는 청구 가능하며 크레딧 환불 적격이 아닙니다.
환불은 DomScan이 자신의 플랫폼이 선택한 검색 모드를 수행하지 못했음을 확인할 때만 가능합니다.
브라우저 렌더링은 페이지가 성공적으로 로드될 것을 보장하지 않으며, 복원력 있는 모드는 재시도가 다른 결과를 생성할 것을 보장하지 않습니다.
스크레이프 특정 사용 제한
이러한 제한은 스크레이프 API에만 적용됩니다. 다른 계정 및 플랫폼 보안 장치도 적용될 수 있습니다.
| 기능 | 무료 계정 | 유료 계정 |
|---|---|---|
| 사용 가능한 모드 | 표준만 | 4가지 모드 모두 |
| 요청 속도 | 분당 5개 요청 | 분당 60개 요청 |
| 동시 표준 또는 복원력 있는 요청 | 1개 표준 요청 | 5개 요청 |
| 동시 렌더링된 요청 | 사용 불가 | 2개 요청 |
| 일일 허용량 | 100개 요청 | 사용 가능한 크레딧 및 속도 제한을 기반으로 함 |
| 월간 허용량 | 500개 요청 | 사용 가능한 크레딧 및 속도 제한을 기반으로 함 |
| 최대 반환 콘텐츠 | 요청당 256 KiB | 요청당 512 KiB |
| 비동기 배치 | 사용 불가 | 사용 가능 |
응답이 적용 가능한 콘텐츠 제한을 초과하면, API는 허용된 부분을 반환하고 응답을 잘렸음으로 표시합니다.
최대 100개의 URL을 비동기로 처리
유료 계정은 최대 100개의 URL을 포함하는 비동기 작업을 제출할 수 있습니다.
분당 최대 5개의 새로운 배치 작업
계정당 최대 3개의 활성 작업
계정당 최대 300개의 대기 중인 URL 항목
한 작업에서 최대 100개의 URL
완료된 결과는 24시간 동안 사용 가능
작업 메타데이터는 7일 동안 보존됨
각 URL은 선택한 모드를 사용하여 독립적으로 청구됩니다.
24시간 이내에 완료된 결과를 다운로드하거나 복사합니다. 그 후 기간이 지나면 제한된 작업 메타데이터가 7일 동안 계속 사용 가능하더라도 응답 콘텐츠가 제거됩니다.
숨겨진 업그레이드 옵션 없이 명확한 범위
CAPTCHA 해결 없음
브라우저 렌더링은 페이지 JavaScript를 실행할 수 있지만, 스크레이프 API는 CAPTCHA를 해결하거나 로그인 요구 사항, 페이월, 접근 제어 또는 기타 제한을 우회하지 않습니다. 대상에서 반환된 CAPTCHA 또는 챌린지 페이지는 대상 사이트 결과이며 환불 불가능합니다.
프리미엄 프록시 선택 없음
검색 모드와 노력 수준을 선택합니다. 프리미엄 프록시, 공급자, 풀 또는 국가 선택 매개변수는 없습니다.
허용되는 사용
스크레이프 API는 법적으로 접근할 수 있고 처리할 수 있는 콘텐츠에만 사용합니다. 해당 법률, 대상 사이트 약관, 개인정보 보호 의무 및 필요한 권한을 준수할 책임이 있습니다.
API를 인증, 페이월, CAPTCHA 또는 접근 제어를 우회하거나, 자격 증명 공격, 계정 학대, 괴롭힘, 불법 감시 또는 개인 데이터의 불법 수집에 사용하지 마십시오. DomScan은 사용이 사람, 서비스 또는 플랫폼에 위협이 되면 요청을 거부하거나 접근을 중단할 수 있습니다.
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
주요 기능
크레딧은 대상 웹사이트에서 반환된 HTTP 상태 또는 콘텐츠가 아니라 요청한 모드에 따라 결정됩니다.
성공적인 API 작업은 DomScan이 선택한 검색 모드를 수행하고 결과 대상 응답을 반환했음을 의미합니다.
유료 계정은 최대 100개의 URL을 포함하는 비동기 작업을 제출할 수 있습니다.
이러한 제한은 스크레이프 API에만 적용됩니다. 다른 계정 및 플랫폼 보안 장치도 적용될 수 있습니다.
브라우저 렌더링은 페이지 JavaScript를 실행할 수 있지만, 스크레이프 API는 CAPTCHA를 해결하거나 로그인 요구 사항, 페이월, 접근 제어 또는 기타 제한을 우회하지 않습니다. 대상에서 반환된 CAPTCHA 또는 챌린지 페이지는 대상 사이트 결과이며 환불 불가능합니다.
스크레이프 API는 법적으로 접근할 수 있고 처리할 수 있는 콘텐츠에만 사용합니다. 해당 법률, 대상 사이트 약관, 개인정보 보호 의무 및 필요한 권한을 준수할 책임이 있습니다.
예제 요청
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"]}'
예제 응답
{
"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"
}
}
자주 묻는 질문
한 URL은 선택한 모드에 따라 1, 2, 10 또는 20 크레딧이 소요됩니다. 배치 항목은 동일한 URL당 가격 책정을 사용합니다.
네. 리디렉션, HTTP 오류, 차단, 챌린지 페이지, 빈 페이지 또는 예상치 못한 콘텐츠와 같은 대상 응답은 DomScan이 여전히 요청된 검색 작업을 수행했으므로 청구 가능합니다.
환불은 DomScan이 자신의 플랫폼이 선택한 검색 모드를 수행하지 못했음을 확인할 때만 가능합니다. 대상 사이트 동작은 플랫폼 실패가 아닙니다.
아니요. 복원력 있는 모드는 첫 번째 결과가 문서화된 재시도 조건을 충족할 때 하나의 재시도를 포함합니다.
아니요. 페이지 JavaScript를 실행하지만 CAPTCHA를 해결하거나 접근 제한을 우회하지 않습니다.
아니요. API는 프록시 계층, 공급자, 풀 또는 국가 지정을 노출하지 않습니다. 검색 모드만 선택합니다.
아니요. 비동기 배치는 유료 계정에만 사용 가능합니다. 무료 계정은 게시된 무료 제한 내에서 표준 모드를 사용할 수 있습니다.
완료된 응답 콘텐츠는 24시간 동안 사용 가능합니다. 제한된 작업 메타데이터는 7일 동안 계속 사용 가능합니다.
관련 도구 및 리소스
HTTP 상태 코드
성공 응답, 인증 문제, 크레딧 부족, 속도 제한, 누락된 데이터, 업스트림 장애를 구분할 수 있도록 클라이언트에서 처리해야 할 HTTP 상태 코드를 문서화했습니다.
요청 성공
캐시 전용 하위 도메인 요청에서 캐시가 없어 백그라운드 새로고침으로 수락되었습니다. 크레딧은 차감되지 않으며 Retry-After 지연 후 다시 시도하세요.
잘못된 매개변수
API 키 또는 세션이 없거나 유효하지 않습니다.
이 요청을 실행할 크레딧이 부족합니다.
인증되었지만 이 작업 또는 모드를 사용할 권한이 없습니다.
성공 응답, 인증 문제, 크레딧 부족, 속도 제한, 누락된 데이터, 업스트림 장애를 구분할 수 있도록 클라이언트에서 처리해야 할 HTTP 상태 코드를 문서화했습니다.
속도 제한 초과
업스트림 서비스를 사용할 수 없거나 일시적으로 속도 제한 중입니다.