본문으로 건너뛰기

API

같은 도메인 데이터베이스를 프로그래밍 방식으로 조회하세요.

인증

API 키를 Bearer 토큰으로(또는 X-API-Key 헤더에 넣어) 보내세요. API 키 생성

curl -H "Authorization: Bearer sk_…" \
  "https://namester.ai/api/v1/domains?view=auction&tld=com&maxPrice=100&sort=ends_at&order=asc"
  • 접근 및 요청 한도: API는 Pro와 Max 플랜에 포함됩니다. 플랜의 시간당 허용량은 모든 키에 합산 적용되며(Pro 시간당 25,000회, Max 시간당 100,000회), 키별로 분당 600회의 버스트 제한이 추가로 적용됩니다. 모든 응답에는 시간 단위 창에 대한 X-RateLimit-* 헤더가 포함되며, 429 응답에는 Retry-After가 포함됩니다. 무료 계정의 키는 402 "API access requires a paid plan"을 받습니다.
  • Claude, Cursor 또는 다른 AI 어시스턴트를 사용하시나요? 같은 키를 다음에 연결하세요: MCP 서버
  • 응답은 code, message, data 필드를 가진 JSON이며, code 0은 성공을 의미합니다.
  • 페이지네이션은 키셋 방식입니다. nextCursor가 null이 될 때까지 그 값을 cursor로 다시 전달하세요.
  • 가격은 USD, 시간은 UTC(ISO 8601)입니다.
  • 기계 판독용 명세: /api/v1/openapi.json

GET/api/v1/domains

도메인 목록. /domains 페이지와 같은 필터를 사용하며, 유료 플랜 전용 필터는 유료 플랜이 없으면 403을 반환합니다.

쿼리 파라미터
파라미터유형설명
qstring
키워드
Keywords; every token must appear in the label (name without the suffix).
anyOfstring (csv)
다음 중 하나 포함
Comma-separated tokens; at least one must appear in the label.
excludestring (csv)
제외
Comma-separated tokens that must not appear in the label.
startsWithstring
시작 문자
Label starts with this text.
endsWithstring
끝 문자
Label ends with this text.
viewall | auction | closeout | buy_now | make_offer | pre_release | pending_delete | deleted | registered
all = every domain with an active listing (best offer); a listing kind = one row per active listing of that kind; deleted / registered = registry drop events.
tldstring (csv)
확장자
Comma-separated public suffixes, e.g. com,io,co.uk.
tldGrouplegacy_gtld | cctld | new_gtld | private (csv)
확장자 그룹
Comma-separated: legacy_gtld, cctld, new_gtld, private.
sourcenamecheap | godaddy | dynadot | sedo | dropcatch | gname | catched | czds | registry-se | registry-pl | registry-uk | registry-au (csv)
소스
Comma-separated data sources.
minPricenumber 0–1000000000
최소 가격
Minimum price in USD (best offer in view=all, the listing price otherwise).
maxPricenumber 0–1000000000
최대 가격
Maximum price in USD.
minLengthinteger 1–63
최소 길이
Minimum label length (characters, IDN decoded).
maxLengthinteger 1–63
최대 길이
Maximum label length.
noHyphenboolean
하이픈 없음
Exclude labels with a hyphen.
noDigitboolean
숫자 없음
Exclude labels with a digit.
onlyDigitsboolean
숫자만
Only all-digit labels.
idnexclude | include | only
IDN
IDN handling: exclude, include (default) or only.
patternstring
패턴
Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL.
minWordsinteger 1–3
최소 단어 수
Minimum dictionary words in the label (1–3).
maxWordsinteger 1–3
최대 단어 수
Maximum dictionary words in the label (1–3).
dictionaryboolean
사전 단어 하나
Label is exactly one dictionary word.
endingWithininteger 1–720
종료까지 남은 시간
Ends within N hours.
minScoreinteger 0–100
최소 점수
Minimum Namester Score (0–100).
maxScoreinteger 0–100
최대 점수
Maximum Namester Score.
minAgeinteger 0–50
최소 연령(년)
Minimum age in years.
minBidsinteger 0–10000
최소 입찰 수
Minimum bids (total across listings in view=all).
minBacklinks유료integer 0–1000000000
최소 백링크
Minimum backlinks. Paid plans only (403 otherwise).
minDr유료integer 0–100
최소 DR
Minimum Ahrefs DR. Paid plans only (403 otherwise).
minTf유료integer 0–100
최소 TF
Minimum Majestic Trust Flow. Paid plans only (403 otherwise).
minCf유료integer 0–100
최소 CF
Minimum Majestic Citation Flow. Paid plans only (403 otherwise).
minTraffic유료integer 0–1000000000
최소 트래픽
Minimum estimated monthly traffic. Paid plans only (403 otherwise).
minTldsTaken유료integer 0–2000
최소 다른 TLD 수 (추적 중)
Minimum number of other TLDs of the same label in our data (TLDs we track, not registry totals). Paid plans only (403 otherwise).
minSearchVolume유료integer 0–1000000000
최소 검색량
Minimum monthly search volume reported by a supplier. Paid plans only (403 otherwise).
minBirthYearinteger 1985–2100
최초 등록 연도 (부터)
Earliest registration year (where a source reports it).
maxBirthYearinteger 1985–2100
최초 등록 연도 (까지)
Latest registration year.
minWaybackYearinteger 1996–2100
최초 Wayback 연도 (부터)
Earliest first Wayback Machine capture year (only names with Wayback data).
maxWaybackYearinteger 1996–2100
최초 Wayback 연도 (까지)
Latest first Wayback capture year.
minWaybackAgeinteger 0–50
최소 Wayback 연령(년)
Minimum years since the first Wayback capture (only names with Wayback data).
daysinteger 1–90
최근
deleted / registered views: look-back window in days (default 7).
sortscore | price | ends_at | length | bids | name | age | first_seen
Sort field. Sorting by a field that can be empty (price, ends_at, age, bids) only returns rows where it is set. deleted / registered support first_seen (event date) and name.
orderasc | desc
asc or desc.
pageSize25 | 50 | 100 | 200
Rows per page: 25, 50, 100 or 200.
cursorstring
Opaque cursor from the previous response (nextCursor).

응답

{
  "code": 0,
  "message": "ok",
  "data": {
    "items": [{ "name": "…", "tld": "com", "score": 72, "kind": "auction",
                "source": "godaddy", "priceUsd": 45, "bids": 3,
                "endsAt": "2026-11-08T14:00:00.000Z", "listings": 2, … }],
    "nextCursor": "eyJzIjoic2NvcmUi…",
    "view": "auction", "sort": "ends_at", "order": "asc",
    "ignoredFilters": []
  }
}

오류: 400 잘못된 파라미터 · 401 키 누락/유효하지 않은 키 · 403 유료 필터 · 404 알 수 없는 도메인 · 429 요청 한도 초과.

GET/api/v1/domains/{name}

도메인 프로필: 소스별 활성 매물, 점수 세부 내역, SEO 지표, 가격 기록, 비교 거래 사례, 다른 확장자, 비슷한 이름.

GET/api/v1/stats

매물 유형, 소스, 레지스트리 이벤트별 재고 합계(최대 5분간 캐시).