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을 반환합니다.
| 파라미터 | 유형 | 설명 |
|---|---|---|
| q | string | 키워드 Keywords; every token must appear in the label (name without the suffix). |
| anyOf | string (csv) | 다음 중 하나 포함 Comma-separated tokens; at least one must appear in the label. |
| exclude | string (csv) | 제외 Comma-separated tokens that must not appear in the label. |
| startsWith | string | 시작 문자 Label starts with this text. |
| endsWith | string | 끝 문자 Label ends with this text. |
| view | all | 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. |
| tld | string (csv) | 확장자 Comma-separated public suffixes, e.g. com,io,co.uk. |
| tldGroup | legacy_gtld | cctld | new_gtld | private (csv) | 확장자 그룹 Comma-separated: legacy_gtld, cctld, new_gtld, private. |
| source | namecheap | godaddy | dynadot | sedo | dropcatch | gname | catched | czds | registry-se | registry-pl | registry-uk | registry-au (csv) | 소스 Comma-separated data sources. |
| minPrice | number 0–1000000000 | 최소 가격 Minimum price in USD (best offer in view=all, the listing price otherwise). |
| maxPrice | number 0–1000000000 | 최대 가격 Maximum price in USD. |
| minLength | integer 1–63 | 최소 길이 Minimum label length (characters, IDN decoded). |
| maxLength | integer 1–63 | 최대 길이 Maximum label length. |
| noHyphen | boolean | 하이픈 없음 Exclude labels with a hyphen. |
| noDigit | boolean | 숫자 없음 Exclude labels with a digit. |
| onlyDigits | boolean | 숫자만 Only all-digit labels. |
| idn | exclude | include | only | IDN IDN handling: exclude, include (default) or only. |
| pattern | string | 패턴 Character pattern: C consonant, V vowel, N digit, H hyphen, L any letter. E.g. CVCV, LLLL. |
| minWords | integer 1–3 | 최소 단어 수 Minimum dictionary words in the label (1–3). |
| maxWords | integer 1–3 | 최대 단어 수 Maximum dictionary words in the label (1–3). |
| dictionary | boolean | 사전 단어 하나 Label is exactly one dictionary word. |
| endingWithin | integer 1–720 | 종료까지 남은 시간 Ends within N hours. |
| minScore | integer 0–100 | 최소 점수 Minimum Namester Score (0–100). |
| maxScore | integer 0–100 | 최대 점수 Maximum Namester Score. |
| minAge | integer 0–50 | 최소 연령(년) Minimum age in years. |
| minBids | integer 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). |
| minBirthYear | integer 1985–2100 | 최초 등록 연도 (부터) Earliest registration year (where a source reports it). |
| maxBirthYear | integer 1985–2100 | 최초 등록 연도 (까지) Latest registration year. |
| minWaybackYear | integer 1996–2100 | 최초 Wayback 연도 (부터) Earliest first Wayback Machine capture year (only names with Wayback data). |
| maxWaybackYear | integer 1996–2100 | 최초 Wayback 연도 (까지) Latest first Wayback capture year. |
| minWaybackAge | integer 0–50 | 최소 Wayback 연령(년) Minimum years since the first Wayback capture (only names with Wayback data). |
| days | integer 1–90 | 최근 deleted / registered views: look-back window in days (default 7). |
| sort | score | 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. |
| order | asc | desc | asc or desc. |
| pageSize | 25 | 50 | 100 | 200 | Rows per page: 25, 50, 100 or 200. |
| cursor | string | 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분간 캐시).