실시간
서비스 상태
통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.
웹 데이터
온페이지 SEO 감사 API
요청당 한 페이지를 감사하고 모든 온페이지 SEO 신호를 하나의 JSON 응답으로 받으세요. 메타 태그, canonical 및 robots 지시어, 제목 구조, 단어 수, 링크, 이미지, Open Graph, 구조화 데이터와 함께 가중치가 적용된 38개 검사와 0~100점이 제공됩니다. render=true를 추가하면 JavaScript 실행 후의 페이지를 감사합니다.
카테고리
웹 데이터
엔드포인트
1
주요 기능
4
자주 묻는 질문
4
다음 회사의 사람들이 사용합니다
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
OpenAPI
API 자료
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
API 키
보호된 액세스
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
10,000
무료 한도
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
이 API로 만들 수 있는 것
이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.
도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.
반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.
제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.
OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.
통합 워크플로
첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.
한 번 인증
문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.
예제로 조회
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
운영 및 모니터링
상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.
개발자 키트
이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.
매개변수 및 응답 맵
엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.
매개변수
urlrender
예제 응답
statusscoremetameta.titlemeta.title_lengthmeta.canonical_self_referencingmeta.indexableheadingsheadings.h1contentcontent.word_countcontent.text_to_html_ratio
HTTP 상태 코드
200400401402429
엔드포인트
GET
/v1/onpage
연동 전 확인할 수 있는 신뢰 신호
투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.
서비스 상태
API 자료
OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.
API 키
보호된 액세스
인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.
무료 한도
무료로 가입하세요
매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.
활성
예제 요청
curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.
주요 기능
원본 또는 렌더링
서버가 보내는 HTML을 감사하거나, render=true를 설정하여 격리된 브라우저에서 JavaScript가 실행된 후의 페이지를 감사하세요. 최신 크롤러가 싱글 페이지 앱을 보는 방식과 같습니다.
가중치가 적용된 38개 검사
각 검사는 제목 누락과 canonical 충돌부터 혼합 콘텐츠, alt 텍스트가 없는 이미지, 건너뛴 제목 수준까지 심각도와 함께 통과, 경고, 실패 또는 해당 없음을 반환합니다.
한 번의 호출로 모든 신호
제목과 설명 길이, meta robots 및 X-Robots-Tag, 언어, viewport, favicon, Open Graph, Twitter cards, 링크 및 이미지 수, 구조화 데이터 유형을 제공합니다.
정직한 알 수 없음
차단되었거나 속도 제한이 걸렸거나 실패한 요청은 사유와 함께 status unknown을 반환하며 환불되므로, 읽지 못한 페이지가 정상 페이지처럼 보이는 일이 없습니다.
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/onpage?url=example.com/shoes/trail-runner&render=true"예제 응답
{
"status": "ok",
"score": 87,
"meta": {
"title": "Trail Running Shoes for Rocky Terrain | Example Outdoor",
"title_length": 55,
"canonical_self_referencing": true,
"indexable": true
},
"headings": { "h1": ["Trail Running Shoes for Rocky Terrain"] },
"content": { "word_count": 122, "text_to_html_ratio": 0.221 },
"checks": [
{ "id": "mixed_content", "status": "fail", "severity": "high", "value": 1 },
{ "id": "images_alt", "status": "warn", "severity": "medium", "value": 1 }
],
"issues": ["mixed_content", "heading_hierarchy", "word_count", "images_alt"]
}자주 묻는 질문
점수는 어떻게 계산하나요?
심각도가 높은 검사는 10점, 중간은 5점, 낮음은 2점의 비중을 갖습니다. 통과하면 전체 점수, 경고는 절반, 실패는 0점을 받습니다. 이미지가 없는 페이지의 이미지 alt 텍스트처럼 해당되지 않는 검사는 제외됩니다.
render=true는 언제 사용해야 하나요?
제목, 콘텐츠, 링크가 스크립트 실행 후에만 나타나는 JavaScript 프레임워크 기반 페이지에 사용하세요. JavaScript SEO API로 두 버전을 비교하면 무엇이 달라지는지 정확히 확인할 수 있습니다.
사이트 전체를 크롤링하나요?
아니요. 요청마다 하나의 URL을 감사하므로 어떤 페이지를 검사하고 얼마를 사용할지 직접 정할 수 있습니다. sitemap 감사 API와 함께 사용하여 감사할 URL을 고르세요.
크레딧은 얼마나 드나요?
원본 HTML 감사는 2크레딧, render=true는 6크레딧입니다. status unknown으로 끝난 결과는 환불됩니다.
관련 도구 및 리소스
HTTP 상태 코드
다음은 처리해야 할 HTTP 상태 코드입니다. 성공 응답, 인증 문제, 크레딧, 속도 제한, 누락된 데이터, 업스트림 장애를 구분하는 데 사용하세요.
성공
200
요청 성공
잘못된 요청
400
잘못된 매개변수
인증되지 않음
401
API 키 또는 세션이 없거나 유효하지 않습니다.
결제 필요
402
이 요청을 실행할 크레딧이 부족합니다.
요청 과다
429
속도 제한 초과
페이지 감사하기