도메인 검색 레시피 API 레퍼런스

제공 내용

클라이언트 연결을 계속 열어 두지 않고도 지원되는 여러 API 요청을 대기열에 넣고 결과를 수집할 수 있습니다.

비동기RESTMCPSDK

다음과 같은 경우 이 제품을 선택하세요

대상 사용자

단일 결정을 위해 집중형 검사를 사용하거나 컨텍스트가 중요할 때 더 넓은 프로필을 구성하세요.

다음과 같은 경우 이 제품을 선택하세요

영어 단일 단어 코퍼스의 조합을 1개에서 5개의 TLD에 걸쳐 확인할 때 선택하세요. 작업당 단어 및 TLD 검사는 최대 100개입니다.

제공 내용

클라이언트 연결을 계속 열어 두지 않고도 지원되는 여러 API 요청을 대기열에 넣고 결과를 수집할 수 있습니다.

엔드포인트

통합하기 전에 지원되는 작업, 입력, 출력, 실행 모드 및 응답 제한을 확인하세요.

POST /v1/domain-discovery/jobs API 레퍼런스 보기

크레딧 및 인증

1 인증 필요. 정확한 비용과 항목별 요금은 작업 레퍼런스에서 확인하세요.

작업 예시

문서화된 작업을 사용해 공개 증거를 수집, 평가, 보강, 검증, 비교, 보호 또는 모니터링하세요.

POST /v1/domain-discovery/jobs

본문 매개변수

매개변수	유형	필수
tlds	string[]	필수
limit	integer	선택 사항
cursor	string	선택 사항
min_length	integer 기본값 `3`	선택 사항
max_length	integer 기본값 `16`	선택 사항
singular_only	boolean 기본값 `false`	선택 사항

응답 필드

필드	유형
`job`	object
`job.id`	string
`job.status`	string
`job.total`	integer
`job.counts`	object
`job.counts.pending`	integer
`job.counts.processing`	integer
`job.counts.succeeded`	integer
`job.counts.failed`	integer
`job.counts.cancelled`	integer
`job.billing`	object
`job.billing.credits_charged`	integer
`job.billing.credits_refunded`	integer
`job.billing.credits_net`	integer
`job.webhook`	object
`job.webhook.configured`	boolean
`job.webhook.status`	string
`job.webhook.attempts`	integer
`job.status_url`	string
`job.results_url`	string
`job.results_csv_url`	string
`job.poll_after_ms`	integer \| null
`job.created_at`	string
`job.started_at`	string \| null
`job.completed_at`	string \| null
`job.cancelled_at`	string \| null
`job.updated_at`	string
`job.processing_deadline_at`	string
`job.results_expires_at`	string
`discovery`	object
`discovery.corpus`	string
`discovery.corpus_version`	string
`discovery.total_matching_words`	integer
`discovery.page_offset`	integer
`discovery.page_words`	integer
`discovery.domain_checks`	integer
`discovery.tlds[]`	string[]
`discovery.filters`	object
`discovery.filters.min_length`	integer
`discovery.filters.max_length`	integer
`discovery.filters.singular_only`	boolean
`discovery.credits_per_domain`	integer
`discovery.next_cursor`	string \| null

예제 요청

curl -X POST "https://domscan.net/v1/domain-discovery/jobs" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "tlds": [
    "io",
    "ai"
  ],
  "limit": 50,
  "min_length": 4,
  "max_length": 8,
  "singular_only": true
}'

예제 응답

{
  "job": {
    "id": "example-id",
    "status": "queued",
    "total": 1,
    "counts": {
      "pending": 1,
      "processing": 1,
      "succeeded": 1,
      "failed": 1,
      "cancelled": 1
    },
    "billing": {
      "credits_charged": 1,
      "credits_refunded": 1,
      "credits_net": 1
    },
    "webhook": {
      "configured": false,
      "status": "not_configured",
      "attempts": 1
    },
    "status_url": "https://example.com",
    "results_url": "https://example.com",
    "results_csv_url": "https://example.com",
    "created_at": "2026-08-27T12:00:00Z",
    "updated_at": "2026-08-27T12:00:00Z",
    "processing_deadline_at": "2026-08-27T12:00:00Z",
    "results_expires_at": "2026-08-27T12:00:00Z",
    "poll_after_ms": 1,
    "started_at": "2026-08-27T12:00:00Z",
    "completed_at": "2026-08-27T12:00:00Z",
    "cancelled_at": "2026-08-27T12:00:00Z"
  },
  "discovery": {
    "corpus": "iannuttall/unclaimed",
    "corpus_version": "example",
    "total_matching_words": 1,
    "page_offset": 1,
    "page_words": 1,
    "domain_checks": 1,
    "tlds": [
      "com",
      "net",
      "org"
    ],
    "filters": {
      "min_length": 1,
      "max_length": 1,
      "singular_only": false
    },
    "credits_per_domain": 1,
    "next_cursor": "example"
  }
}