웹 인텔리전스 2 엔드포인트 6 주요 기능

통합 URL 인텔리전스 API

공개 URL을 보내면 정규화된 페이지 메타데이터, 미리보기 자산, 리디렉션 근거, 구조화 데이터 유형, 보안 헤더, 공개 아이덴티티 신호를 하나의 응답으로 제공합니다.

카테고리 웹 인텔리전스
엔드포인트 2
주요 기능 6
자주 묻는 질문 5

연동 전 확인할 수 있는 신뢰 신호

투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.

실시간 서비스 상태

통합하기 전에 실시간 서비스 상태와 문서화된 실패 응답을 확인하세요.

OpenAPI API 자료

OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.

API 키 보호된 액세스

인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.

10,000 무료 한도

매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.

이 API로 만들 수 있는 것

이 페이지를 프로덕션 요약으로 사용하세요. 엔드포인트, 예제, 응답 구조, DomScan을 제품에 연결하는 워크플로 구성 요소를 제공합니다.

제품 워크플로

도메인 검사, DNS 인텔리전스, 위험 신호 또는 보강 데이터를 온보딩, 검색, 내부 도구에 포함하세요.

분석가 자동화

반복적인 수동 조회를 예약 작업, 알림, 재현 가능한 조사 단계로 대체하세요.

깔끔한 JSON 데이터

제공자 페이지를 스크래핑하지 않고 예측 가능한 필드, 문서화된 상태 코드, 크레딧 비용을 사용하세요.

AI 및 운영 도구

OpenAPI, SDK, Postman 또는 MCP를 통해 에이전트, 대시보드, SOAR 플레이북, CRM에 데이터를 공급하세요.

통합 워크플로

첫 요청부터 반복 가능한 프로덕션 사용까지의 단순한 경로입니다.

1
한 번 인증

문서화된 헤더로 API 키를 보내고 서비스 전반에서 요청을 일관되게 유지하세요.

2
예제로 조회

curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.

3
운영 및 모니터링

상태 코드, 크레딧 비용, 응답 필드를 사용해 재시도, 로그, 알림을 구축하세요.

개발자 키트

이 페이지에서 기계 판독 문서, 요청 컬렉션, SDK 또는 에이전트 도구로 바로 이동하세요.

매개변수 및 응답 맵

엔드포인트를 클라이언트에 연결하기 전에 입력, 출력 필드, 상태 코드를 확인하세요.

요청 매개변수

매개변수

url
응답 필드

예제 응답

requested_urlfinal_urlstatustitlecanonical_urlopen_graphstructured_datastructured_data.typesstructured_data.itemsstructured_data.parse_errorsmetameta.cached
상태 범위

HTTP 상태 코드

200400401402429500502503504

엔드포인트

GET /v1/url-intelligence
크레딧: 2인증: 인증이 필요합니다
POST /v1/url-intelligence/bulk
크레딧: 2인증: 인증이 필요합니다

연동 전 확인할 수 있는 신뢰 신호

투명한 문서, 인증된 요청, 보이는 안정성 정보로 출시 전에 DomScan을 더 쉽게 평가할 수 있습니다.

서비스 상태 API 자료

OpenAPI, Swagger, Postman, CLI, SDK, MCP 링크를 바로 확인할 수 있습니다.

API 키 보호된 액세스

인증 엔드포인트는 API 키를 사용하며 호출 전 명확한 크레딧 비용을 보여줍니다.

무료 한도 무료로 가입하세요

매월 10,000 크레딧으로 시작하고 사용량이 늘 때만 업그레이드하세요.

활성 예제 요청

curl 및 HTTP 샘플에서 시작한 뒤 매개변수를 애플리케이션 코드에 매핑하세요.

주요 기능

정규화된 페이지 메타데이터

제목, 설명, 언어, 콘텐츠 유형, 최종 URL, 정식 URL을 추출합니다.

링크 미리보기 필드

정규화된 이미지, 파비콘, Open Graph 태그, Twitter Cards로 미리보기 카드를 만들 수 있습니다.

구조화 데이터 요약

제한 없이 페이지 데이터를 반환하지 않고 JSON-LD 유형을 식별하고 잘못된 블록을 보고합니다.

robots 및 보안 신호

검색 엔진 색인 지시문과 허용 목록에 포함된 공개 보안 헤더를 읽습니다.

연락처 및 공개 프로필

사이트가 명시한 이메일, 전화번호, 소셜, 개발자, 크리에이터 링크를 추출합니다.

URL 메타데이터 일괄 조회

제한된 동시 처리와 항목별 오류로 요청당 최대 10개 URL을 검사합니다.

예제 요청

GET /v1/url-intelligence?url=https://example.com bash
curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/url-intelligence
POST /v1/url-intelligence/bulk bash
curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"urls":["https://example.com","https://github.com/about"]}' https://domscan.net/v1/url-intelligence/bulk

예제 응답

200 OK json
{
  "requested_url": "https://example.com/",
  "final_url": "https://example.com/",
  "status": 200,
  "title": "Example Domain",
  "canonical_url": "https://example.com/",
  "open_graph": {},
  "structured_data": { "types": [], "items": 0, "parse_errors": 0 },
  "meta": { "cached": false, "fetch_transport": "worker" }
}

자주 묻는 질문

URL 메타데이터 API와 Open Graph API는 무엇이 다른가요?

Open Graph API는 소셜 태그에 중점을 둡니다. DomScan은 정식 URL, 리디렉션, robots, 구조화 데이터, 보안, 연락처, 아이덴티티 신호도 반환합니다.

Open Graph 태그가 없으면 어떻게 되나요?

Open Graph 필드는 비어 있지만 표준 제목, 설명, 아이콘, 구조화 데이터와 그 밖의 사용 가능한 신호는 계속 반환됩니다.

API가 JavaScript를 실행하나요?

아니요. 초기 버전은 크기가 제한된 공개 HTML 응답을 검사하며 클라이언트 측 JavaScript가 실행된 뒤에만 나타나는 메타데이터를 확인했다고 주장하지 않습니다.

API가 리디렉션을 안전하게 따라가나요?

예. 리디렉션 횟수는 제한되며 각 대상이 검사되어 사설 또는 내부 네트워크 대상에 접근하지 못하도록 합니다.

여러 URL을 한 번에 검사할 수 있나요?

예. 일괄 엔드포인트는 최대 10개의 공개 URL을 받고 입력 순서를 유지합니다.

관련 도구 및 리소스

HTTP 상태 코드

성공 응답, 인증 문제, 크레딧 부족, 속도 제한, 누락된 데이터, 업스트림 장애를 구분할 수 있도록 클라이언트에서 처리해야 할 HTTP 상태 코드를 문서화했습니다.

성공 200

요청 성공

잘못된 요청 400

잘못된 매개변수

인증되지 않음 401

API 키 또는 세션이 없거나 유효하지 않습니다.

결제 필요 402

이 요청을 실행할 크레딧이 부족합니다.

요청 과다 429

속도 제한 초과

서버 오류 500

내부 오류

잘못된 게이트웨이 502

상위 RDAP 오류

서비스 이용 불가 503

업스트림 서비스를 사용할 수 없거나 일시적으로 속도 제한 중입니다.

게이트웨이 시간 초과 504

업스트림 조회가 시간 초과되었습니다.

URL 인텔리전스로 개발하기