API

TLD-List에 표시된 데이터를 프로그래밍 방식으로 조회하고 가져옵니다.

API 개선을 위해 노력하고 있습니다

강력하고 직관적인 JSON API가 곧 출시될 예정입니다. 이 API를 통해 기업 사용자들은 TLD-List의 실시간 데이터베이스에서 데이터를 조회할 수 있게 됩니다. 이 사이트에 표시된 거의 모든 데이터를 API를 통해 접근할 수 있으며, 사용자 정의 파라미터로 필터링이 가능합니다.

경고: API는 현재 개발 중이며 기능이 추가될 수 있으며, 향후 새로운 메소드와 매개변수가 추가될 수 있습니다. 변경된 모든 기능은 기존 기능과 하위 호환성을 유지합니다.

개요

TLD-List v1 API를 사용하여 TLD-List 에 표시된 데이터를 라이브 데이터베이스에서 검색할 수 있습니다.

API는 JSON 데이터가 포함된 HTTP POST를 수락하고 JSON 데이터로 응답합니다. 모든 API 메소드 요청에 대한 요구 사항입니다:

  • 요청은 HTTP POST 메서드를 사용하여 이루어져야 합니다.
  • 요청에는 인증을 위한 유효한 공개 및 비공개 API 키 쌍이 포함된 JSON 본문이 있어야 합니다.
  • 요청에는 헤더가 포함되어야 합니다: 콘텐츠 유형: application/json

매개변수는 JSON으로 인코딩된 요청 본문에서 키/값으로 API에 전달됩니다.

모든 API 요청의 기본 URL은 다음과 같습니다: https://api.tld-list.com/v1

인증

인증은 메소드 URL에 게시된 JSON 본문에 공개 API 키와 비공개 API 키를 전달하여 수행됩니다. 모든 API 호출에는 유효한 API 키쌍이 포함되어야 합니다. API 키쌍은 TLD-List 계정의 API 탭에서 생성할 수 있습니다.

계정 > API로 이동하여 API 키를 생성합니다.

API 키는 매개변수 apiKeyPublic (공개 키) 및 apiKeyPrivate (비공개 키)를 사용하여 JSON 요청 본문에서 전달됩니다.

Example authentication parameters

'{'
"apiKeyPublic":"MY_PUBLIC_KEY",
"apiKeyPrivate":"MY_PRIVATE_KEY"
'}'

응답

모든 성공적인 API 응답에는 200 SUCCESS HTTP 상태 코드와 JSON으로 인코딩된 본문이 포함됩니다. 응답에 다른 HTTP 상태 코드가 있으면 요청이 실패했으며 오류가 발생했음을 나타냅니다.

API가 반환하는 JSON 응답 객체는 다음과 같은 구조를 갖습니다:

유형설명
statusstring요청의 상태를 지정합니다. 성공은 API 호출이 성공했음을 나타내고 실패는 요청이 실패했음을 나타냅니다.
errorsarray of objects발생한 오류를 나타내는 객체의 배열입니다. 각 오류 객체에는 다음이 포함됩니다:

코드: 오류 유형을 식별하는 문자열

메시지: 오류를 설명하는 사람이 읽을 수 있는 문자열

매개변수: 요청에 전달된 특정 매개변수에 문제가 있음을 나타내는 선택적 문자열 또는 문자열 배열입니다.

오류가 발생하지 않은 경우 오류 배열은 비어 있습니다.

자세한 내용은 오류 코드를 참조하세요.
secondsnumberAPI 서버가 응답을 생성하는 데 걸린 시간(초)입니다.
datastring|array|object요청된 데이터가 포함된 객체, 배열 또는 문자열입니다.

오류가 있는 실패한 응답 객체 예시

'{'
"errors" : [
'{'
"code" : "PARAMETER_INVALID",
"message" : "pricetypes parameter must be a non-empty array",
"parameter" : "pricetypes"
},
'{'
"code" : "PARAMETER_INVALID",
"message" : "includeRegistrars parameter contains invalid registrar names: foobar",
"parameter" : "includeRegistrars"
}
],
"seconds" : 0.001,
"status" : "FAIL"
'}'

성공적인 응답 개체 예시

'{'
"data" : [
'{'
"cheapest" : '{'
"renewal" : [
'{'
"id" : "sav",
"name" : "Sav",
"price" : "8.38"
}
],
},
"currency" : "USD",
"name" : "com",
"registrarsIncluded" : 58,
"registrarsTotal" : 58
}
],
"errors" : [],
"seconds" : 0.001,
"status" : "SUCCESS"
'}'

공통 응답 개체

일부 API 메서드는 동일한 구조의 데이터 객체를 반환합니다. 이러한 공통 데이터 객체는 아래에 자세히 설명되어 있습니다.

RegistrarPricing

특별 약관, 수수료, 세금 및 프로모션과 같은 추가 세부 정보를 포함하여 특정 가격 유형(register, renewal, transfer)에 대한 등록기관의 연장 소매 가격을 설명합니다.

경로유형설명
idstring등록기관을 고유하게 식별하는 등록기관 ID 문자열입니다.
namestring등록기관의 이름을 표시합니다.
pricestring확장 및 가격 유형에 대한 등록기관의 최종 소매 가격입니다.

참고: 이 필드는 RegistrarPricing 개체가 가격 유형의 컨텍스트에 중첩되어 있는 경우에만 표시됩니다(예: getCheapestRegistrars의 응답에서).
priceOriginalstring숫자 문자열로 확장자에 대한 등록기관의 일반 소매 가격입니다. 이 필드는 가격이 프로모션 가격인 경우에만 표시됩니다.

참고: 이 필드는 RegistrarPricing 개체가 가격 유형의 컨텍스트에 중첩된 경우에만 표시됩니다(예: getCheapestRegistrars의 응답에서).
pricetypestring확장 가격 유형, 다음 중 하나: register, renewal, transfer.

참고: 이 필드는 RegistrarPricing 개체가 가격 유형의 컨텍스트에 중첩된 경우에만 표시됩니다(예: getCheapestRegistrars의 응답에서).
pricesobject모든 가격 유형에 대한 확장 기능에 대한 등록기관의 소매 가격입니다.
prices[pricetype]string확장 및 [가격 유형]에 대한 등록기관의 최종 소매 가격이며, 여기서 [가격 유형] 키는 register, renewal, transfer, restore, whoisprivacy 입니다. 예시:

'{'
"register": "8.73",
"renewal": "9.73",
"transfer": "9.73",
"whoisPrivacy": "0.00"
'}'
pricesOriginalobject모든 가격 유형에 대한 확장에 대한 등록기관의 일반 소매 가격입니다. 등록기관에 활성 프로모션이 없는 경우 이 필드는 표시되지 않습니다.
pricesOriginal[pricetype]string확장자 및 [가격 유형]에 대한 등록기관의 일반 소매 가격이며, 여기서 [가격 유형] 키는 register, renewal, transfer, restore, whoisprivacy 입니다.
promoobject이 확장 및 가격 유형에 대한 등록기관의 가격에 적용된 프로모션 가격을 나타내는 RegistrarPromo 객체입니다. 프로모션이 적용되지 않은 경우 이 필드는 표시되지 않습니다. 프로모션 객체 예시:

'{'
"code": "MYCOUPONCODE",
"amount": "20.00",
"type": "discount-percent",
"start": "2015-06-22T00:00:00",
"end": "2025-06-22T00:00:00"
'}'


참고: 이 필드는 RegistrarPricing 개체가 가격 유형의 컨텍스트에 중첩되어 있는 경우에만 표시됩니다(예: getCheapestRegistrars의 응답).
promosarray of objects이 확장에 대해 등록기관이 제공하는 모든 활성 프로모션 가격을 나타내는 RegistrarPromo 객체의 배열입니다.
termsobject등록기관의 가격 책정에 적용되는 특별 약관을 나타내는 개체 모음입니다. 적용되는 특별 약관이 없는 경우 이 필드는 존재하지 않습니다. 각 하위 객체에는 용어 ID가 키로 지정됩니다.

limitPerCustomer - 고객당 특정 수의 도메인에 대해서만 가격이 유효하도록 지정합니다.
newCustomerOnly - 신규 고객에게만 가격이 유효하도록 지정합니다.
affiliateLink - 고객이 제휴사 링크를 통해 등록기관의 사이트에 액세스하는 경우에만 가격이 유효하도록 지정합니다.
nameserverLockIn - 구매한 도메인은 등록기관의 네임서버만 사용할 수 있도록 지정합니다.
idSubmissionRequired - 고객이 구매를 완료하려면 사진이 부착된 신분증 또는 사업자 등록증을 제출해야 한다고 지정합니다.

용어 개체 예시:

'{'
"limitPerCustomer": '{'
"pricetype": [
"register"
],
"count": 1
},
"newCustomerOnly": '{'
"pricetype": [
"register"
]
},
"affiliateLink": '{'
"pricetype": [
"register"
]
},
"multiYearPurchaseRequired": '{'
"pricetype": [
"register"
],
"count": 2
},
"nameserverLockIn": '{'
"pricetype": [
"register",
"renewal",
"transfer"
]
},
"idSubmissionRequired": '{'
"pricetype": [
"register",
"renewal",
"transfer"
]
}
'}'
terms[term].countnumber기간에 따라 고객을 제한하는 수량입니다. 예를 들어 카운트가 1이면 고객은 지정된 가격의 도메인 1개로 제한됩니다. 이 필드가 적용되지 않으면 표시되지 않습니다.
terms[term].pricetypearray of strings해당 용어가 적용되는 가격 유형: register, renewal, transfer. 이 필드는 RegistrarPricing 개체의 가격 유형이 지정되지 않은 경우에만 표시됩니다.
notesobject등록기관의 가격 책정과 관련된 메모를 나타내는 객체 모음입니다. 가격 책정 메모가 없는 경우 이 값은 빈 객체가 됩니다. 각 하위 객체는 노트 ID로 키가 지정됩니다: currencyExchangeRate, feeIcann, feeTax, feePayment
notes.feeIcannobjectTLD의 최종 가격(일반적으로 $0.18 USD)에 ICANN 수수료가 추가되었는지 여부를 지정합니다. 이 메모가 있으면 등록기관이 광고 가격에 ICANN 수수료를 포함하지 않고 대신 고객 결제 시 TLD's 가격에 추가 요금으로 추가한다는 의미입니다.

fee_icann 참고 사항 개체 예시:

'{'
"feeIcann": '{'
"pricetype": [
"register",
"renewal",
"transfer"
],
"amount": "0.18",
"addedToListPrice": true
}
'}'

가격 유형 필드는 수수료가 적용되는 가격 유형을 지정하며, 추가된 목록 가격 필드는 최종 가격에 수수료가 추가되었음을 나타냅니다.
notes.feeTaxarray of objects등록기관에서 부과하는 다양한 세율, 세금이 적용되는 고객 및 계산된 세금이 TLD의 최종 가격에 포함되었는지 여부를 지정합니다. 등록기관이 광고 가격에 세금을 포함하지 않고 모든 고객에게 세금이 부과되는 경우에만 TLD의 최종 가격에 세금이 포함된다는 점에 유의하시기 바랍니다.

수수료 세금 개체 배열의 예입니다:

'{'
"feeTax": [
'{'
"addedToListPrice": false,
"appliesToCustomers": [
"eu",
"us",
"in"
],
"amountRateType": "percent",
"amountRate": "13",
"type": "hst"
},
'{'
"addedToListPrice": false,
"appliesToCustomers": [
"ca"
],
"amountRateType": "percent",
"amountRate": "5",
"type": "gst"
}
]
'}'
notes.feeTax[].typestring세금 유형을 설명하는 레이블(예: 부가가치세의 경우 'vat', 상품 및 서비스세의 경우 'gst ' 등)입니다.
notes.feeTax[].amountRatenumber|string세율 금액. 세율이 숫자로 표시되거나 위치 등의 고객 기준에 따라 세율이 달라짐을 나타내는 문자열 '~ '가 표시됩니다.
notes.feeTax[].amountRateTypestring문자열 값 '퍼센트 '는 금액세율 값이 숫자 백분율임을 나타냅니다. 문자열 값 '퍼센트-지역별로 다름 '은 세율이 고객의 청구 지역 또는 국가에 따라 다름을 나타냅니다.
notes.feeTax[].appliesToCustomersstring|array of strings문자열 '* '는 모든 고객에게 세금이 적용됨을 나타냅니다. 그렇지 않으면 이 값은 세금이 적용되는 국가를 정의하는 ISO 3166-1 알파 2 국가 코드 문자열의 배열이 됩니다. 한 가지 주목해야 할 예외 사항은 이 배열에 유럽 연합의 모든 국가를 나타내는 비국가 코드 문자열 'eu'가 포함될 수 있다는 점입니다.
notes.feeTax[].addedToListPriceboolean계산된 세금 금액이 최종 가격에 추가되었는지 여부를 나타냅니다.
notes.feePaymentobject등록기관이 고객의 결제 방법에 따라 추가 수수료를 부과하는지 여부와 해당 수수료가 TLD의 최종 가격에 포함되었는지 여부를 지정합니다.
feePayment 개체 예시:

'{'
"feePayment": '{'
"addedToListPrice": false,
"amountRate": "~",
"amountRateMin": "0.9",
"amountRateMax": "20",
"amountRateType": "percent-varies-by-method"
}
'}'
notes.feePayment.amountRatestring수수료 금액. 수수료 비율을 숫자로 표시하거나 결제 방법 등 고객 기준에 따라 수수료 비율이 달라짐을 나타내는 문자열 '~ '로 표시합니다.
notes.feePayment.amountRateMinstring최소 수수료 금액은 수수료가 변동되는 경우에만 적용됩니다.
notes.feePayment.amountRateMaxstring최대 수수료 금액은 수수료가 가변적인 경우에만 적용됩니다.
notes.feePayment.amountRateTypestring문자열 값 '퍼센트 '는 금액요금 값이 숫자 백분율임을 나타냅니다. 문자열 값 '퍼센트-방법별 '은 수수료가 고객의 결제 방법에 따라 달라지는 백분율임을 나타냅니다.
notes.feePayment.addedToListPriceboolean계산된 수수료 금액이 최종 가격에 추가되었는지 여부를 나타냅니다.
notes.currencyExchangeRateobject등록기관의 가격이 다른 국가 통화로 표시되어 있으며 USD 로 변환되었음을 지정합니다. 통화 변환의 세부 사항은 다음과 같이 표시됩니다.

base: 등록기관의 가격 책정 통화를 3글자 코드(예: EUR)로 표시합니다.
quote: 가격이 변환된 통화(항상 USD 임)
rate: 통화 변환에 사용된 환율입니다.

currencyExchangeRate 노트 객체 예시:

'{'
"currencyExchangeRate": '{'
"base": "GBP",
"quote": "USD",
"rate": "1.2482"
}
'}'
threeYearValueScorenumber3년 동안 등록기관을 통해 이 확장자로 도메인을 소유할 때 가격 및 무료 기능에 따라 결정되는 가치를 수치로 측정한 것입니다. 숫자가 클수록 더 많은 가치가 제공됩니다.
currencystring가격 데이터의 세 글자 ISO 4217 통화 코드입니다. 이 값은 현재 USD.
freeFeaturesarray of objects등록기관이 도메인 소유권과 함께 제공하는 무료 기능을 나타내는 개체 배열입니다. 객체에는 각 기능의 수량과 기간이 포함됩니다.

dns - 무료 DNS 서비스.
whois-privacy - WHOIS 개인정보 보호 서비스.
email-account - 무료 이메일 계정.
email-forward - 무료 이메일 전달.
ssl-cert - 무료 기본 SSL 인증서.

무료 기능 배열의 예입니다:

[
'{'
"name": "dns"
},
'{'
"name": "whois-privacy"
},
'{'
"name": "email-account",
"count": 5
},
'{'
"name": "ssl-cert",
"duration": 365
}
]
freeFeatures[].countnumber등록기관이 무료로 제공하는 기능의 수량입니다. 해당되지 않는 경우 이 필드는 표시되지 않습니다.
freeFeatures[].durationnumber등록기관에서 기능을 무료로 제공하는 일수입니다. 기간이 365이면 기능이 1년 동안 무료로 제공됩니다. 해당되지 않는 경우 이 필드는 표시되지 않습니다.

RegistrarPromo

등록기관에서 제공하는 활성 프로모션을 설명합니다. 예시:

'{'
"code": "MYCOUPONCODE",
"amount": "20.00",
"type": "discount-percent",
"start": "2015-06-22T00:00:00",
"end": "2025-06-22T00:00:00"
'}'

경로유형설명
promo.codestring할인 혜택을 받기 위해 고객이 결제 시 입력해야 하는 프로모션 코드입니다.
promo.amountstring프로모션 가격의 숫자 금액입니다. 프로모션 유형에 따라 할인된 가격(가격), 정상 가격에서 차감된 금액(할인) 또는 정상 가격에서 차감된 백분율 금액(할인 퍼센트)이 될 수 있습니다.
promo.typestring프로모션 가격 유형을 나타내는 문자열입니다.

가격 - 프로모션의 금액 필드가 새로운 할인 가격임을 의미합니다
할인 - 프로모션의 금액 필드에서 정상 가격을 차감하여 적용 가격을 얻었음을 의미합니다
할인-퍼센트 - 프로모션의 금액 필드가 백분율이며, 정상 가격에서 백분율을 차감하여 적용 가격을 얻었음을 의미합니다.
promo.startstring프로모션이 시작된 시점의 ISO 8601 날짜 시간(UTC 표준 시간대). 특정 시작 날짜가 없는 경우 표시되지 않습니다. 예시: 2015-06-22T00:00:00
promo.endstring프로모션이 종료되는 ISO 8601 날짜 시간(UTC 표준 시간대)입니다. 특정 종료 날짜가 없는 경우 표시되지 않습니다. 예시: 2025-06-22T00:00:00
promo.pricetypearray of strings프로모션이 적용되는 가격 유형: register, renewal, transfer.

참고: 이 필드는 가격 유형의 컨텍스트에 중첩된 경우에만 표시됩니다(예: getCheapestRegistrars의 응답).

오류 코드

요청 실패 시 JSON 응답 객체에는 무엇이 잘못되었는지 설명하는 오류 객체가 하나 이상 포함될 수 있습니다. 다음은 오류 객체의 코드 필드에 설정할 수 있는 식별 오류 코드의 포괄적이지 않은 목록입니다.

코드설명
502API 서버를 일시적으로 사용할 수 없습니다.
RATE_LIMITED클라이언트 API 요청 수가 허용된 최대치를 초과했습니다.
INVALID_METHOD요청된 API 메서드가 존재하지 않습니다.
SYSTEM알 수 없는 시스템 오류가 발생했습니다.
RESPONSE_TIMEOUT응답을 생성하는 동안 API 서버가 시간 초과되었습니다.
PARAMETER_REQUIRED호출된 메서드에 필요한 매개 변수를 클라이언트에서 제공하지 않았습니다.
ACCOUNT_INACTIVE고객의 계정이 더 이상 활성화되지 않았으며 API 액세스를 위해 구독 갱신이 필요합니다.
NO_ACCESS클라이언트의 계정 수준은 API 액세스 권한을 부여하지 않습니다. API 액세스를 위해서는 계정 업그레이드가 필요합니다.
AUTH_INVALID인증 실패: 제공된 API 키가 비활성 상태이거나 유효하지 않습니다.
CLIENT_IPS_EXCEEDED제공된 API 키쌍에 대해 API에 액세스할 수 있는 최대 고유 클라이언트 IP를 초과했습니다.
REQUEST_ENDED_BY_CLIENT응답이 생성되기 전에 클라이언트에 의해 요청이 종료되었습니다.

제한

API 사용에는 남용을 방지하기 위해 특정 제한이 적용됩니다. 이러한 사용 제한은 아래와 같으며 사전 통지 없이 변경될 수 있습니다.

API 사용에는 남용을 방지하기 위해 특정 제한이 적용됩니다.

유형설명
계정당 API 키3
요금 한도100 15 분당 최대 요청 수
API 키당 클라이언트 IP 주소5 1440 분당 키당 고유 클라이언트 IP 주소

확장 방법

get

확장 및 관련 가격 및 세부 정보 데이터를 반환합니다. 이 메서드는 이 메서드에서 반환하지 않는 "최저가 내역" 데이터를 제외하고 하나 이상의 TLD 세부 정보 페이지(예: .com)에 표시되는 데이터를 검색하는 것과 유사합니다(내역 데이터는 getAggregateHistory 메서드 참조).

API 엔드포인트: https://api.tld-list.com/v1/extension/get

응답 시간: ~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

요청 매개변수

유형필수설명
extensionsarray of strings아니요

검색할 확장명을 지정합니다. 앞에 점을 포함하지 마십시오. 확장자 이름은 유니코드 또는 그에 상응하는 푼니코드일 수 있습니다. 생략하면 TLD-List 에 나열된 모든 확장명이 반환됩니다.

예: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]

includeFieldsarray of strings아니요키 이름으로 반환할 특정 데이터를 지정합니다. 이 매개변수에 제출되지 않은 키는 생략됩니다. 기본적으로 사용 가능한 모든 필드가 반환됩니다. 사용 가능한 필드 목록은 응답 테이블을 참조하세요. 중첩된 필드는 지원되지 않습니다.

예: "includeFields": ["name", "registrars", "dnssecSupported"]

excludeFieldsarray of strings아니요키 이름으로 제외할 특정 데이터를 지정합니다. 이 매개변수로 제출된 키는 생략됩니다. 기본적으로 제외되는 필드는 없습니다. 사용 가능한 필드 목록은 응답 테이블을 참조하세요. 중첩된 필드는 지원되지 않습니다.

예: "excludeFields": ["available", "syntax", "sponsor"]

includeRegistrarsarray of strings아니요

결과에 포함할 활성 등록기관의 문자열 ID입니다. getIds 메서드를 사용하여 TLD-List 에 등록된 모든 등록기관의 ID 목록을 가져옵니다.

예: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]

excludeRegistrarsarray of strings아니요

결과에서 제외할 활성 등록기관의 문자열 ID입니다. getIds 메서드를 사용하여 TLD-List 에 활성화된 모든 등록기관의 ID 목록을 가져옵니다.

예: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]

omitExtensionsWithoutRegistrarsboolean아니요

true인 경우 결과에 등록기관 가격 데이터가 없는 확장자는 생략됩니다. 기본적으로 모든 익스텐션이 포함됩니다.

예: "omitExtensionsWithoutRegistrars": true

응답 객체

경로유형설명
dataarray of objects확장자 이름의 배열입니다.
data[].availableobjectTLD 단계 사용 가능 날짜의 개체입니다.
data[].available.generalobject일반 대중이 도메인 등록을 사용할 수 있는 시점의 ISO 8601 날짜 시간(UTC 표준 시간대)입니다.
data[].available.sunriseobjectTLD's 선라이즈 단계(상표 소유자가 해당 도메인의 등록을 신청할 수 있는 시점)를 나타내는 시작종료 날짜/시간 범위의 개체입니다. 예시:

'{'
"sunrise": '{'
"start": "2017-06-19T00:00:00.000Z",
"end": "2017-08-21T00:00:00.000Z"
}
'}'
data[].available.trademarkobjectTLD's 상표 단계(상표와 일치하는 도메인이 등록된 경우 상표 등록기관에서 상표 소유자에게 통지하는 기간)를 나타내는 시작종료 날짜/시간 범위의 개체입니다. 예시:

'{'
"trademark": '{'
"start": "2019-06-18T00:00:00.000Z",
"end": "2020-09-21T00:00:00.000Z"
}
'}'
data[].available.otherarray of objectsTLD의 다양한 발사 단계와 해당 날짜/시간 범위(예: "Land Rush" 및 "Qualified Launch Program")를 나타내는 개체의 배열입니다. 예시:

'{'
"other": [
'{'
"end": "2020-09-18T00:00:00.000Z",
"name": "Limited Community Priority Period",
"start": "2019-09-17T00:00:00.000Z",
"type": "limited-registration-period"
},
'{'
"end": "2018-07-03T00:00:00.000Z",
"name": "Restricted Land Rush 1",
"start": "2017-10-23T00:00:00.000Z",
"type": "limited-registration-period"
},
'{'
"end": "2019-09-16T00:00:00.000Z",
"name": "Invitation Priority Access",
"start": "2017-08-22T00:00:00.000Z",
"type": "limited-registration-period"
},
'{'
"end": "2017-08-21T00:00:00.000Z",
"name": "Qualified Launch Program",
"start": "2017-06-19T00:00:00.000Z",
"type": "qualified-launch-program"
}
]
'}'
data[].averageobject포함된 등록기관에 대한 가격 유형별 확장 기능의 평균 가격을 포함하는 개체입니다. 예시:

'{'
"average": '{'
"register": "7.63",
"renewal": "13.63",
"transfer": "9.63"
}
'}'
data[].average[pricetype]string가격 유형] 키가 register, renewal, transfer, restore, whoisprivacy 인 경우 [ 가격 유형]에 대한 숫자 문자열로 확장 프로그램의 평균 가격입니다.
data[].categorystringTLD가 분류된 카테고리입니다.

id - TLD-List 에서 내부적으로 사용하는 정수형 카테고리 ID.
idstr - 대체 문자열 카테고리 ID.
name - 영문 카테고리 이름.
desc - 영문 카테고리 설명.

카테고리 배열의 예시입니다:

[
'{'
"id": 4,
"idstr": "services",
"name": "Services",
"desc": "TLDs for representing the service industry."
},
'{'
"id": 6,
"idstr": "food",
"name": "Food & Drink",
"desc": "Domain extensions for dining, cooking, restaurants, and beverages."
}
]
data[].dnssecSupportedboolean레지스트리의 DNS 영역이 DNSSEC(DNS 보안 확장)를 지원하는 경우.
data[].hasPremiumDomainsobject가격 유형] 키와 부울 값의 객체로, 레지스트리에서 일부 "프리미엄" 도메인 네임에 대해 더 높은 가격을 청구하는지 여부를 나타냅니다. 예시:

'{'
"hasPremiumDomains": '{'
"register": false,
"renewal": false
}
'}'
data[].infoUpdatedstringTLD's 기본 정보(제한 사항, 이용 가능 날짜 등)가 마지막으로 확인 및 업데이트된 시점의 ISO 8601 날짜 시간(UTC 표준 시간대). 참고: 새로운 updated.info 날짜가 반드시 데이터 변경이 발생했음을 나타내는 것은 아닙니다. 데이터가 마지막으로 확인되고 설정된 시점만 나타냅니다.
data[].intendedUsagestring등록자가 확장 프로그램을 사용할 것으로 예상되는 방식에 대한 일반 정보입니다.
data[].languagestringISO 639-1 2자 언어 코드입니다. 언어가 영어 기반이거나 알 수 없는 경우 이 필드가 표시되지 않습니다.
data[].levelinteger확장자의 도메인 레벨을 나타내는 정수입니다. 1 = 최상위 도메인, 2 = 최상위 도메인, 3 = 최상위 도메인 등입니다.
data[].localPresenceRequiredboolean레지스트리에서 등록자에게 해당 지역에 실제 주소가 있어야 한다고 요구하는 경우.
data[].medianobject포함된 등록기관에 대한 가격 유형별 확장 기능의 중간 가격을 포함하는 개체입니다. 예시:

'{'
"median": '{'
"register": "3.17",
"renewal": "20.17",
"transfer": "8.17"
}
'}'
data[].median[pricetype]string가격 유형] 키가 register, renewal, transfer, restore, whoisprivacy 인 경우 [ 가격 유형]에 대한 숫자 문자열로서의 확장 가격의 중간값입니다.
data[].namestring도메인 확장자의 유니코드 이름입니다.
data[].nameserversarray등록된 도메인의 권한 있는 네임서버를 저장하는 레지스트리의 루트 네임서버입니다. 네임서버 배열 예시입니다:

'{'
"nameservers": [
'{'
"host": "a.gtld-servers.net",
"ipv4": "192.5.6.30",
"ipv6": "2001:503:a83e:0:0:0:2:30"
},
'{'
"host": "b.gtld-servers.net",
"ipv4": "192.33.14.30",
"ipv6": "2001:503:231d:0:0:0:2:30"
}
]
'}'
data[].parentTldstring확장자의 상위 최상위 도메인입니다. TLD인 경우 이 필드는 표시되지 않습니다.
data[].pricingUpdatedstringTLD's 등록기관 가격을 마지막으로 확인하고 업데이트한 ISO 8601 날짜 시간(UTC 표준 시간대)입니다. 참고: 새로운 updated.pricing 날짜가 반드시 데이터 변경이 발생했음을 나타내는 것은 아닙니다. 데이터가 마지막으로 확인 및 설정된 시기만 나타냅니다.
data[].punycodestring도메인 확장자의 퍼니코드 이름입니다. IDN 확장자에만 표시됩니다.
data[].registerMaxYearsinteger구매 시 도메인을 등록할 수 있는 최대 연한은 다음과 같습니다.
data[].registerMinYearsinteger구매 시 도메인을 등록할 수 있는 최소 기간입니다.
data[].registrarsIncludedinteger반환된 등록기관 배열에 포함된 등록기관의 개수입니다.
data[].registrarsTotalinteger확장 프로그램을 판매하는 총 활성 등록기관의 수입니다.
data[].registrarsarray of objects등록기관 가격 및 기능 데이터가 포함된 RegistrarPricing 객체의 배열입니다.
data[].registryUrlstring레지스트리의 공식 웹사이트에서 TLD 등록 정보를 확인할 수 있습니다.
data[].renewalMinYearsinteger도메인을 갱신할 수 있는 최소 허용 연한입니다.
data[].restrictionsstringTLD's 등록 제한 및 요구 사항에 대한 간단한 설명. 제한 사항이 없는 경우 이 필드는 표시되지 않습니다.
data[].sponsorobject확장 프로그램의 후원 조직 또는 관리 조직에 대한 데이터가 포함된 개체입니다.
data[].sponsor.namestring확장 프로그램의 ICANN 승인 후원 기관 또는 ccTLD 관리 기관의 이름입니다.
data[].sponsor.addressstring후원 조직의 실제 위치 또는 ccTLD 관리 조직. 주소 배열 예시:

'{'
"sponsor": '{'
"address": [
"Minerva House",
"Edmund Halley Road",
"Oxford Science Park",
"Oxford OX4 4DQ",
"United Kingdom"
]
}
'}'
data[].sponsorParentCompanystring스폰서 조직에 대한 지배 지분을 소유한 법인의 이름입니다.
data[].romanizedstring라틴 문자로 변환된 TLD입니다. 언어가 영어 기반이거나 알 수 없는 경우 이 필드가 표시되지 않습니다.
data[].rtlstring확장자를 "오른쪽에서 왼쪽"으로 읽는 경우(예: Arabric TLDs), 이 값은 __true__. "왼쪽에서 오른쪽"으로 읽는 경우 이 값은 __false__. 알 수 없는 경우 이 값은 존재하지 않습니다.
data[].syntaxobject확장에 허용된 도메인 이름 규칙 및 제한 사항에 대한 세부 정보가 포함된 개체입니다.
data[].syntax.minCharsinteger등록할 수 있는 레이블의 최소 글자 수입니다.
data[].syntax.maxCharsinteger레이블에 등록할 수 있는 최대 글자 수입니다.
data[].targetMarketstringTLD가 서비스를 제공하려는 사람 또는 단체입니다.
data[].translationstringTLD의 영어 번역입니다. TLD가 이미 영어 기반이거나 번역을 알 수 없는 경우 이 값은 표시되지 않습니다.
data[].typestring다음 문자열 중 하나로 식별되는 TLD 유형입니다:

gTLD
ccTLD : 국가 코드 최상위 도메인
grTLD: 일반 제한 최상위 도메인 sTLD
: 스폰서 최상위 도메인.
data[].wholesaleobject가격 유형별 확장자의 도매 가격이 포함된 개체입니다. 도매 가격은 도메인 네임 구매 시 레지스트리에서 등록기관에 청구하는 가격입니다. 예시:

'{'
"wholesale": '{'
"register": "8.97",
"renewal": "8.97",
"transfer": "8.97"
}
'}'
data[].whoisPrivacySupportedboolean확장 프로그램을 통해 WHOIS 개인정보 보호 서비스에서 등록자의 이름과 연락처 정보를 마스킹할 수 있도록 허용하는 경우입니다. 알 수 없는 경우 이 필드가 표시되지 않습니다.
data[].whoisServerboolean도메인 등록자 연락처 정보를 저장하는 레지스트리 서버의 호스트 이름입니다.

요청/응답 예시

curl -X POST https://api.tld-list.com/v1/extension/get -H 'Content-Type: application/json' -d '{'"extensions": ["com"], "includeRegistrars": ["porkbun","godaddy","epik"], "apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY"'}'

'{'
"data" : [
'{'
"nameservers" : [
'{'
"host" : "a.gtld-servers.net",
"ipv4" : "192.5.6.30",
"ipv6" : "2001:503:a83e:0:0:0:2:30"
}
],
"pricingUpdated" : "2023-02-04T11:04:33",
"registerMaxYears" : 10,
"registerMinYears" : 1,
"registrars" : [{"id":"godaddy","name":"GoDaddy"}],
"type" : "gTLD",
"whoisPrivacySupported" : true,
"whoisServer" : "whois.verisign-grs.com",
"wholesale" : '{'
"register" : "8.97",
"renewal" : "8.97",
"transfer" : "8.97"
}
}
],
"errors" : [],
"seconds" : 0.068,
"status" : "SUCCESS"
'}'

getNames

모든 확장자 이름을 반환합니다.

API 엔드포인트: https://api.tld-list.com/v1/extension/getNames

응답 시간: ~1 second

요청 매개변수

유형필수설명
omitExtensionsWithoutRegistrarsboolean아니요true인 경우 결과에 등록기관 가격 데이터가 없는 확장자는 생략됩니다. 기본값은 거짓입니다.
wantPunycodeboolean아니요반환된 모든 IDN 확장자를 유니코드 대신 퍼니코드로 인코딩합니다. 기본값은 false 입니다.

응답 객체

경로유형설명
dataarray of strings확장자 이름의 배열입니다.

요청/응답 예시

curl -X POST https://api.tld-list.com/v1/extension/getNames -H 'Content-Type: application/json' -d '{'"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY", "wantPunycode": true, "omitExtensionsWithoutRegistrars": true'}'

'{'
"data" : [
"2000.hu",
"5g.in",
"aaa.pro",
"xn--3bst00m",
"xn--j6w193g"
],
"errors" : [],
"seconds" : 0.697,
"status" : "SUCCESS"
'}'

getCheapestRegistrar

도메인 확장자당 가장 저렴한 등록기관/공급업체, 해당 가격, 중간 가격 및 평균 가격을 반환합니다. 등록기관에서 판매하지 않는 확장자는 반환되지 않습니다.

API 엔드포인트: https://api.tld-list.com/v1/extension/getCheapestRegistrar

응답 시간: ~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

요청 매개변수

유형필수설명
pricetypesarray of strings아니요

검색할 가격 유형을 지정합니다. 생략하면 3개의 가격 유형(register, renewal, transfer)이 반환됩니다.

예: "pricetypes": ["register", "transfer"]

extensionsarray of strings아니요

검색할 확장명을 지정합니다. 앞에 점을 포함하지 마십시오. 확장자 이름은 유니코드 또는 그에 상응하는 푼니코드일 수 있습니다. 생략하면 TLD-List 에 나열된 모든 확장명이 반환됩니다.

예: "extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]

includeRegistrarsarray of strings아니요

가장 저렴한 가격 및 집계 계산을 결정할 때 포함할 활성 등록기관의 문자열 ID입니다. 이 매개변수에 지정되지 않은 등록업체는 무시됩니다. TLD-List 에 등록된 모든 등록업체의 ID 목록을 가져오려면 getIds 메서드를 사용합니다.

이 매개 변수를 생략하면 TLD-List 에 등록된 모든 등록 대행사가 고려됩니다.

예: "includeRegistrars": ["godaddy", "porkbun", "namecheap"]

excludeRegistrarsarray of strings아니요

가장 저렴한 가격 및 집계 계산을 결정할 때 제외할 활성 등록업체의 문자열 ID입니다. TLD-List 에 등록되어 있는 모든 등록기관의 ID 목록을 가져오려면 getIds 메서드를 사용합니다.

이 매개변수를 생략하면 등록업체가 무시되지 않습니다.

예: "excludeRegistrars": ["godaddy", "porkbun", "namecheap"]

omitExtensionsWithoutRegistrarsboolean아니요

true인 경우 결과에 등록기관 가격 데이터가 없는 확장은 생략됩니다. 이 상황은 전달된 excludeRegistrars 및/또는 includeRegistrars 매개 변수로 인해 일반적으로 등록기관 가격 데이터가 있는 확장에 일치하는 등록기관 가격 데이터가 없는 경우에 발생합니다. 이러한 확장자는 기본적으로 포함되지만 가격 책정 데이터에 대한 배열이 비어 있습니다. 결과에서 이러한 확장을 생략하려면 true로 설정합니다.

예: "omitExtensionsWithoutRegistrars": true

응답 객체

경로유형설명
dataarray of objects각각 도메인 확장자를 나타내는 객체의 배열입니다.
data[].namestring도메인 확장자의 유니코드 이름입니다.
data[].punycodestring도메인 확장자의 퍼니코드 이름입니다. IDN 확장자에만 표시됩니다.
data[].currencystring가격 데이터의 세 글자 ISO 4217 통화 코드입니다. 이 값은 현재 USD.
data[].registrarsIncludednumber반환된 가격 데이터에 포함된 등록기관의 수입니다.
data[].averageobject포함된 등록기관에 대한 가격 유형별 확장 기능의 평균 가격을 포함하는 개체입니다.
data[].average[pricetype]string가격 유형] 키가 register, renewal, transfer 인 경우 [ 가격 유형]에 대한 숫자 문자열로 확장 프로그램의 평균 가격입니다.
data[].medianobject포함된 등록기관에 대한 가격 유형별 확장 기능의 중간 가격이 포함된 개체입니다.
data[].median[pricetype]string가격 유형] 키가 register, renewal, transfer 인 경우 [ 가격 유형]에 대한 숫자 문자열로서의 확장 가격의 중간값입니다.
data[].cheapestobject가격 유형별로 확장에 대한 가장 저렴한 등록 기관을 포함하는 개체입니다.
data[].cheapest[pricetype]array of objects

가격 유형]별로 가장 저렴한 등록기관을 포함하는 RegistrarPricing 객체의 배열(여기서 [가격 유형] 키는 register, renewal, transfer 입니다).

확장에 대한 가장 저렴한 가격이 여러 등록기관에서 동일할 수 있으므로 이 데이터는 배열입니다.

요청/응답 예시

curl -X POST https://api.tld-list.com/v1/extension/getCheapestRegistrar -H 'Content-Type: application/json' -d '{'"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY", "includeRegistrars": ["godaddy", "namecheap", "porkbun"], "extensions": ["com", "co.uk"]'}'

'{'
"data" : ['{'
"average" : '{'
"register" : "7.85",
"renewal" : "10.25",
"transfer" : "11.99"
},
"cheapest" : '{'
"register" : ['{'
"id" : "porkbun",
"name" : "Porkbun",
"price" : "4.96"
}],
"renewal" : ['{'
"price" : "5.96"
}],
"transfer" : ['{'
"price" : "11.99"
}]
},
"name" : "co.uk"
}],
"errors" : [],
"seconds" : 0.126,
"status" : "SUCCESS"
'}'

등록 방법

getIds

TLD-List 에 등록된 등록기관을 고유하게 식별하는 모든 등록기관 ID를 반환합니다.

API 엔드포인트: https://api.tld-list.com/v1/registrar/getIds

응답 시간: < 1 second

요청 매개변수

없음

응답 객체

경로유형설명
dataarray of strings문자열 등록기관 ID의 배열입니다.

요청/응답 예시

curl -X POST https://api.tld-list.com/v1/registrar/getIds -H 'Content-Type: application/json' -d '{'"apiKeyPublic":"MY_PUBLIC_KEY","apiKeyPrivate":"MY_PRIVATE_KEY"'}'

'{'
"data" : [
"101domain",
"123reg",
"above.com",
"upflare",
"webnames.ca"
],
"errors" : [],
"seconds" : 0.001,
"status" : "SUCCESS"
}

대기자 명단에 참여

TLD-List 뉴스레터

새 기능, 사이트 뉴스 및 버그 수정에 대한 업데이트를 받으려면 이메일 뉴스레터에 가입하세요.