API

TLD-List पर प्रदर्शित डेटा को प्रोग्रामेटिक रूप से क्वेरी और पुनः प्राप्त करें।

एपीआई v1 प्रलेखन

समर्थित विधियों, पैरामीटर्स, लौटाए गए डेटा और उदाहरणों के बारे में जानकारी.

चेतावनी: एपीआई वर्तमान में विकास के अधीन है और परिवर्तन के अधीन है। भविष्य में नई विधियाँ, पैरामीटर और सुविधाएँ जोड़ी जा सकती हैं. किए गए कोई भी परिवर्तन मौजूदा कार्यक्षमता के साथ पीछे की ओर संगत रहेंगे।

सिंहावलोकन

टीएलडी-सूची v1 एपीआई का उपयोग अपने लाइव डेटाबेस से टीएलडी-सूची पर प्रदर्शित डेटा को पुनर्प्राप्त करने के लिए किया जा सकता है।

एपीआई HTTP POSTs के माध्यम से JSON एन्कोडेड डेटा को स्वीकार करता है और लौटाता है। सभी एपीआई विधि अनुरोधों के लिए आवश्यकताएं:

अनुरोध HTTP POST विधि का उपयोग करके किए जाने चाहिए
अनुरोधों में प्रमाणीकरण के लिए एक वैध सार्वजनिक और निजी एपीआई कुंजी जोड़ी वाला एक JSON निकाय होना चाहिए", अनुरोधों में हेडर शामिल होना चाहिए: Content-Type: application/json

पैरामीटर को API को JSON एन्कोडेड अनुरोध निकाय में कुंजी/मान के रूप में पारित किया जाता है।

सभी एपीआई अनुरोधों के लिए आधार URL है:https://api.tld-list.com/v1

प्रमाणीकरण

विधि URL पर पोस्ट किए गए JSON बॉडी में एक सार्वजनिक API कुंजी और एक निजी API कुंजी पास करके प्रमाणीकरण किया जाता है। सभी API कॉल में एक मान्य API कुंजीपेयर शामिल होना चाहिए. एपीआई टैब के तहत आपके टीएलडी-सूची खाते में एपीआई कीपेयर उत्पन्न की जा सकती हैं।

API कुंजियाँ बनाने > लिए API खाता पर जाएँ.

एपीआई कुंजियों को पैरामीटर एपीआईकीपब्लिक (आपकी सार्वजनिक कुंजी) और एपीआईकीप्राइवेट (आपकी निजी कुंजी) का उपयोग करके जेएसओएन अनुरोध निकाय में पारित किया जाता है।

Example authentication parameters

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

प्रतिक्रिया

सभी सफल एपीआई प्रतिक्रियाओं में एक 200 SUCCESS HTTP स्थिति कोड और एक JSON एन्कोडेड बॉडी होगी। प्रतिसाद में कोई अन्य HTTP स्थिति कोड इंगित करता है कि अनुरोध विफल रहा और कोई त्रुटि उत्पन्न हुई.

एपीआई द्वारा लौटाए गए सभी JSON प्रतिक्रिया ऑब्जेक्ट में निम्न संरचना होगी:

कुंजी	प्रकार	विवरण
`status`	string	अनुरोध की स्थिति निर्दिष्ट करता है. `SUCCESS` इंगित करता है कि API कॉल सफल था, `FAIL` इंगित करता है कि अनुरोध विफल रहा।
`errors`	array of objects	हुई त्रुटियों का प्रतिनिधित्व करने वाले ऑब्जेक्ट्स की सरणी. प्रत्येक त्रुटि ऑब्जेक्ट में शामिल होंगे: `code`: त्रुटि के प्रकार की पहचान करने वाली स्ट्रिंग `message`: त्रुटि का वर्णन करने वाली मानव-पठनीय स्ट्रिंग `parameter`: वैकल्पिक स्ट्रिंग अनुरोध में पारित एक निश्चित पैरामीटर के साथ एक समस्या को इंगित करता है। यदि कोई त्रुटि उत्पन्न नहीं हुई, तो `errors` सरणी रिक्त हो जाएगी.
`seconds`	number	एपीआई सर्वर को प्रतिक्रिया उत्पन्न करने में कितना समय लगा (सेकंड में)।
`data`	string\|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\"
'}'

सामान्य प्रतिक्रिया ऑब्जेक्ट्स

कई एपीआई विधियां डेटा ऑब्जेक्ट्स को वापस करती हैं जिनकी संरचना समान होती है। इन सामान्य, साझा डेटा ऑब्जेक्ट्स को नीचे विस्तार से वर्णित किया गया है।

RegistrarPricing

किसी विशेष मूल्य प्रकार (register, renewal, transfer) के विस्तार के लिए रजिस्ट्रार के खुदरा मूल्य निर्धारण का वर्णन करता है, जिसमें विशेष शर्तें, शुल्क, कर और प्रचार जैसे अतिरिक्त विवरण शामिल हैं।

पथ	प्रकार	विवरण
`id`	string	रजिस्ट्रार आईडी स्ट्रिंग जो विशिष्ट रूप से रजिस्ट्रार की पहचान करती है।
`name`	string	रजिस्ट्रार का नाम प्रदर्शित करें.
`price`	string	एक संख्यात्मक स्ट्रिंग के रूप में विस्तार के लिए रजिस्ट्रार का खुदरा मूल्य।
`priceOriginal`	string	एक संख्यात्मक स्ट्रिंग के रूप में विस्तार के लिए रजिस्ट्रार का नियमित खुदरा मूल्य। यह फ़ील्ड केवल तभी मौजूद होगी जब `price` प्रचार मूल्य हो. नोट: यह फ़ील्ड केवल तब मौजूद होती है जब रजिस्ट्रारप्राइसिंग ऑब्जेक्ट को मूल्य प्रकार के संदर्भ में नेस्टेड किया जाता है (उदाहरण के लिए, getCheapestRegistrars की प्रतिक्रिया में)।
`pricetype`	string	एक्सटेंशन मूल्य निर्धारण का प्रकार, एक: `register`, `renewal`, `transfer`।
`prices`	object	सभी मूल्य प्रकारों के विस्तार के लिए रजिस्ट्रार का खुदरा मूल्य निर्धारण।
`prices[pricetype]`	string	विस्तार और [मूल्य प्रकार] के लिए रजिस्ट्रार का अंतिम खुदरा मूल्य, जहां [मूल्य प्रकार] कुंजी `register`, `renewal`, `transfer`, `restore`, `whoisprivacy` है। उदाहरण: __नमूना__
`pricesOriginal`	object	सभी मूल्य प्रकारों के विस्तार के लिए रजिस्ट्रार का नियमित खुदरा मूल्य निर्धारण। यदि रजिस्ट्रार के पास कोई सक्रिय `promos`नहीं है तो यह फ़ील्ड मौजूद नहीं होगी।
`pricesOriginal[pricetype]`	string	विस्तार और [मूल्य प्रकार] के लिए रजिस्ट्रार का नियमित खुदरा मूल्य, जहां [मूल्य प्रकार] कुंजी `register`, `renewal`, `transfer`, `restore`, `whoisprivacy` है।
`promo`	object	प्रचार मूल्य निर्धारण का प्रतिनिधित्व करने वाली एक वस्तु जिसे इस विस्तार के लिए रजिस्ट्रार की कीमत पर लागू किया गया है। यदि कोई प्रोमो लागू नहीं किया गया है, तो यह फ़ील्ड मौजूद नहीं होगी. उदाहरण प्रोमो ऑब्जेक्ट: __नमूना__
`promos`	array of objects	इस विस्तार के लिए रजिस्ट्रार द्वारा प्रस्तावित सभी सक्रिय प्रचार मूल्य निर्धारण का प्रतिनिधित्व करने वाले रजिस्ट्रारप्रोमो ऑब्जेक्ट्स की सरणी।
`terms`	object	विशेष शब्दों का प्रतिनिधित्व करने वाली वस्तुओं का एक संग्रह जो रजिस्ट्रार के मूल्य निर्धारण पर लागू होता है। यदि कोई विशेष शर्तें लागू नहीं होती हैं, तो यह फ़ील्ड मौजूद नहीं होगी. प्रत्येक उप ऑब्जेक्ट को एक शब्द ID के साथ कुंजीबद्ध किया गया है: `limitPerCustomer` - निर्दिष्ट करता है कि मूल्य निर्धारण केवल प्रति ग्राहक डोमेन की एक निश्चित संख्या के लिए मान्य है। `newCustomerOnly` - निर्दिष्ट करता है कि मूल्य निर्धारण केवल नए ग्राहकों के लिए मान्य है। `affiliateLink` - निर्दिष्ट करता है कि मूल्य निर्धारण केवल तभी मान्य होता है जब ग्राहक एक सहबद्ध लिंक के माध्यम से रजिस्ट्रार की साइट तक पहुंचता है। `nameserverLockIn` - निर्दिष्ट करता है कि खरीदे गए डोमेन केवल रजिस्ट्रार के नेमसर्वर का उपयोग कर सकते हैं। `idSubmissionRequired` - निर्दिष्ट करता है कि ग्राहक को खरीद को पूरा करने के लिए अपनी फोटो आईडी या व्यवसाय पंजीकरण जमा करना होगा। उदाहरण शब्द ऑब्जेक्ट्स: __नमूना__
`terms[term].count`	number	वह मात्रा जो यह शब्द ग्राहक को सीमित करती है। उदाहरण के लिए, यदि `count = 1`, तो ग्राहक निर्दिष्ट मूल्य पर 1 डोमेन तक सीमित है। यदि यह फ़ील्ड लागू नहीं होती है तो यह मौजूद नहीं होगी.
`terms[term].pricetype`	array of strings	मूल्य प्रकार (ओं) शब्द पर लागू होता है: `register`, `renewal`, `transfer`। यह फ़ील्ड केवल तभी मौजूद होगी जब रजिस्ट्रारप्राइसिंग ऑब्जेक्ट का मूल्य प्रकार निर्दिष्ट नहीं है.
`notes`	object	नोट्स का प्रतिनिधित्व करने वाली वस्तुओं का एक संग्रह जो रजिस्ट्रार के मूल्य निर्धारण से संबंधित है। यदि कोई मूल्य निर्धारण नोट नहीं हैं, तो यह मान एक खाली वस्तु होगी। प्रत्येक उप ऑब्जेक्ट को नोट्स ID के साथ कुंजीबद्ध किया गया है: `currencyExchangeRate`, `feeIcann`, `feeTax`, `feePayment`
`notes.feeIcann`	object	निर्दिष्ट करता है कि क्या TLD (आमतौर पर $ 0.18 USD) के लिए अंतिम मूल्य में एक ICANN शुल्क जोड़ा गया है। यदि यह नोट मौजूद है, तो इसका मतलब है कि रजिस्ट्रार अपने विज्ञापित मूल्य में ICANN शुल्क शामिल नहीं करता है, और इसके बजाय इसे ग्राहक चेकआउट पर TLD's मूल्य में अतिरिक्त शुल्क के रूप में जोड़ता है। उदाहरण `fee_icann` नोट ऑब्जेक्ट: '{' \"feeIcann\": '{' \"pricetype\": [ \"register\", \"renewal\", \"transfer\" ], \"amount\": \"0.18\", \"addedToListPrice\": true '}' '}' `pricetype` फ़ील्ड निर्दिष्ट करता है कि कौन से मूल्य प्रकार शुल्क के अधीन हैं, और `addedToListPrice` फ़ील्ड इंगित करता है कि शुल्क अंतिम मूल्य में जोड़ा गया है.
`notes.feeTax`	array of objects	एक रजिस्ट्रार द्वारा लगाए गए विभिन्न कर दरों को निर्दिष्ट करता है, जिन ग्राहकों पर कर लागू होता है, और यदि गणना किए गए कर को टीएलडी के लिए अंतिम मूल्य में शामिल किया गया है। कृपया ध्यान दें कि करों को केवल टीएलडी के लिए अंतिम मूल्य में शामिल किया जाता है यदि रजिस्ट्रार अपने विज्ञापित मूल्यों में कर शामिल नहीं करता है और सभी ग्राहकों से कर लगाया जाता है। वस्तुओं की उदाहरण `feeTax` सरणी: '{' \"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[].type`	string	कर के प्रकार का वर्णन करने वाला लेबल, अर्थात `'vat'` मूल्य वर्धित कर के लिए, `'gst'` माल और सेवा कर के लिए, आदि।
`notes.feeTax[].amountRate`	number\|string	कर की दर की राशि। यह या तो एक संख्या के रूप में कर प्रतिशत दर होगी, या स्ट्रिंग `'~'` यह दर्शाती है कि कर की दर ग्राहक मानदंडों के आधार पर भिन्न होती है, जैसे स्थान।
`notes.feeTax[].amountRateType`	string	स्ट्रिंग मान `'percent'` इंगित करता है कि `amountRate` मान एक संख्यात्मक प्रतिशत है। स्ट्रिंग मूल्य `'percent-varies-by-location'` इंगित करता है कि कर की दर ग्राहक के बिलिंग क्षेत्र या देश के आधार पर भिन्न होती है।
`notes.feeTax[].appliesToCustomers`	string\|array of strings	स्ट्रिंग `'*'` इंगित करता है कि कर सभी ग्राहकों पर लागू होता है। अन्यथा यह मान आईएसओ 3166-1 अल्फा -2 देश कोड स्ट्रिंग्स की एक सरणी होगी जो परिभाषित करेगी कि कौन से देश कर के अधीन हैं। ध्यान देने योग्य एक अपवाद: सरणी में गैर-देश कोड स्ट्रिंग `'eu'`हो सकती है, जो यूरोपीय संघ के सभी देशों का प्रतिनिधित्व करती है।
`notes.feeTax[].addedToListPrice`	boolean	इंगित करता है कि गणना की गई कर राशि अंतिम मूल्य में जोड़ी गई है या नहीं।
`notes.feePayment`	object	निर्दिष्ट करता है कि क्या रजिस्ट्रार ग्राहक की भुगतान विधि के आधार पर अतिरिक्त शुल्क लेता है, और यदि शुल्क को टीएलडी के लिए अंतिम मूल्य में शामिल किया गया है। उदाहरण `feePayment` ऑब्जेक्ट: '{' \"feePayment\": '{' \"addedToListPrice\": false, \"amountRate\": \"~\", \"amountRateMin\": \"0.9\", \"amountRateMax\": \"20\", \"amountRateType\": \"percent-varies-by-method\" '}' '}'
`notes.feePayment.amountRate`	string	शुल्क राशि। यह या तो एक संख्या के रूप में शुल्क प्रतिशत दर होगी, या स्ट्रिंग `'~'` यह दर्शाती है कि शुल्क दर ग्राहक मानदंडों के आधार पर भिन्न होती है, जैसे कि भुगतान विधि।
`notes.feePayment.amountRateMin`	string	न्यूनतम शुल्क राशि, केवल तभी लागू होती है जब शुल्क परिवर्तनशील हो।
`notes.feePayment.amountRateMax`	string	अधिकतम शुल्क राशि, केवल तभी लागू होती है जब शुल्क परिवर्तनशील हो।
`notes.feePayment.amountRateType`	string	स्ट्रिंग मान `'percent'` इंगित करता है कि `amountRate` मान एक संख्यात्मक प्रतिशत है। स्ट्रिंग मान `'percent-varies-by-method'` इंगित करता है कि शुल्क एक प्रतिशत है जो ग्राहक की भुगतान विधि के आधार पर भिन्न होता है।
`notes.feePayment.addedToListPrice`	boolean	इंगित करता है कि गणना की गई शुल्क राशि अंतिम मूल्य में जोड़ी गई है या नहीं।
`notes.currencyExchangeRate`	object	निर्दिष्ट करता है कि रजिस्ट्रार की कीमतें किसी अन्य राष्ट्रीय मुद्रा में सूचीबद्ध थीं, और USD में परिवर्तित हो गई हैं। मुद्रा रूपांतरण के विवरण को इस प्रकार दर्शाया गया है: `base`: 3 अक्षर कोड (यानी EUR) के रूप में रजिस्ट्रार की मूल्य निर्धारण मुद्रा `quote`: जिस मुद्रा में कीमतों को परिवर्तित किया गया था (हमेशा USD होगा) `rate`: मुद्रा रूपांतरण करने के लिए उपयोग की जाने वाली विनिमय दर। उदाहरण `currencyExchangeRate` नोट ऑब्जेक्ट: '{' \"currencyExchangeRate\": '{' \"base\": \"GBP\", \"quote\": \"USD\", \"rate\": \"1.2482\" '}' '}'
`threeYearValueScore`	number	मूल्य का एक संख्यात्मक माप, मूल्य निर्धारण और मुफ्त सुविधाओं द्वारा निर्धारित, 3 साल की अवधि के लिए रजिस्ट्रार के माध्यम से इस विस्तार के साथ एक डोमेन का मालिक होने के लिए। संख्या जितनी बड़ी होती है, उतना ही अधिक मूल्य की पेशकश की जाती है।
`currency`	string	मूल्य निर्धारण डेटा का तीन-अक्षर आईएसओ 4217 मुद्रा कोड। यह मान वर्तमान में केवल `USD`है।
`freeFeatures`	array of objects	डोमेन स्वामित्व के साथ रजिस्ट्रार द्वारा प्रदान की जाने वाली मुफ्त सुविधाओं का प्रतिनिधित्व करने वाली वस्तुओं की एक सरणी। ऑब्जेक्ट में प्रत्येक सुविधा की मात्रा और अवधि शामिल है। प्रत्येक ऑब्जेक्ट को एक मुफ्त सुविधा आईडी के साथ कुंजीबद्ध किया गया है: `dns` - नि: शुल्क DNS सेवा. `whois-privacy` - WHOIS गोपनीयता सेवा. `email-account` - मुफ्त ईमेल खाता (ओं)। `email-forward` - मुफ्त ईमेल अग्रेषण. `ssl-cert` - नि: शुल्क बुनियादी एसएसएल प्रमाण पत्र (ओं)। उदाहरण मुक्त सुविधा सरणी: __नमूना__
`freeFeatures[].count`	number	रजिस्ट्रार द्वारा मुफ्त में प्रदान की जाने वाली सुविधा की मात्रा। यदि यह फ़ील्ड लागू नहीं होती है तो यह मौजूद नहीं होगी.
`freeFeatures[].duration`	number	रजिस्ट्रार द्वारा मुफ्त में सुविधा की पेशकश के दिनों की संख्या। `duration = 365`यदि सुविधा, तो सुविधा 1 वर्ष के लिए मुफ्त में दी जाती है। यदि यह फ़ील्ड लागू नहीं होती है तो यह मौजूद नहीं होगी.

RegistrarPromo

रजिस्ट्रार द्वारा प्रदान किए गए सक्रिय प्रचार का वर्णन करता है. उदाहरण:

__नमूना__

पथ	प्रकार	विवरण
`promo.code`	string	रियायती पदोन्नति प्राप्त करने के लिए ग्राहक को चेकआउट पर प्रोमो कोड दर्ज करना होगा।
`promo.amount`	string	प्रचार मूल्य निर्धारण की संख्यात्मक राशि। प्रोमो के प्रकार के आधार पर, यह रियायती मूल्य (), नियमित मूल्य से घटाई गई राशि (`price`), या नियमित मूल्य से`discount` घटाई गई प्रतिशत राशि ()`discount-percent` हो सकती है।
`promo.type`	string	प्रचार मूल्य निर्धारण के प्रकार का प्रतिनिधित्व करने वाली एक स्ट्रिंग। निम्न मानों में से एक होगा: `price` - इसका मतलब है कि प्रोमो की राशि फ़ील्ड नई रियायती कीमत है `discount` - इसका मतलब है कि प्रोमो की राशि फ़ील्ड को लागू मूल्य प्राप्त करने के लिए नियमित मूल्य से घटाया गया था `discount-percent` - इसका मतलब है कि प्रोमो की राशि क्षेत्र एक प्रतिशत है, और लागू मूल्य प्राप्त करने के लिए प्रतिशत को नियमित मूल्य से घटाया गया था।
`promo.start`	string	प्रोमो कब शुरू हुआ इसका आईएसओ 8601 डेटटाइम (यूटीसी टाइमज़ोन)। यदि कोई विशिष्ट प्रारंभ तिथि नहीं थी तो उपस्थित नहीं होंगे। उदाहरण: `2015-06-22T00:00:00`
`promo.end`	string	प्रोमो कब समाप्त होगा इसका आईएसओ 8601 डेटटाइम (यूटीसी टाइमज़ोन)। यदि कोई विशिष्ट समाप्ति तिथि नहीं है तो उपस्थित नहीं होंगे। उदाहरण: `2025-06-22T00:00:00`
`promo.pricetype`	array of strings	प्रोमो जिस मूल्य प्रकार पर लागू होता है: `register`, `renewal`, `transfer`। नोट: यह फ़ील्ड केवल तब मौजूद होती है जब किसी मूल्य प्रकार के संदर्भ में नेस्टेड किया जाता है (उदाहरण के लिए, getCheapestRegistrars की प्रतिक्रिया में)।

त्रुटि कोड

अनुरोध विफलता पर, JSON प्रतिक्रिया ऑब्जेक्ट में एक या अधिक त्रुटि ऑब्जेक्ट हो सकते हैं जो वर्णन करते हैं कि क्या गलत हुआ। नीचे त्रुटि कोड की पहचान करने की एक गैर-व्यापक सूची दी गई है जिसे त्रुटि ऑब्जेक्ट के फ़ील्ड में सेट किया जा सकता है code ।

कोड	विवरण
502	API सर्वर अस्थायी रूप से अनुपलब्ध है।
RATE_LIMITED	क्लाइंट API अनुरोधों की संख्या अधिकतम अनुमत है.
INVALID_METHOD	अनुरोधित API विधि मौजूद नहीं है।
SYSTEM	कोई अज्ञात सिस्टम त्रुटि उत्पन्न हुई.
RESPONSE_TIMEOUT	प्रतिक्रिया उत्पन्न करते समय एपीआई सर्वर टाइम आउट किया गया।
PARAMETER_REQUIRED	क्लाइंट द्वारा कॉल की गई विधि के लिए एक आवश्यक पैरामीटर प्रदान नहीं किया गया था।
ACCOUNT_INACTIVE	क्लाइंट का खाता अब सक्रिय नहीं है और API पहुँच के लिए सदस्यता नवीनीकरण आवश्यक है।
NO_ACCESS	क्लाइंट का खाता स्तर API पहुँच प्रदान नहीं करता है। API पहुँच के लिए खाता नवीनीकरण आवश्यक है.
AUTH_INVALID	प्रमाणीकरण विफल रहा: प्रदान की गई API कुंजियाँ निष्क्रिय या अमान्य हैं।
CLIENT_IPS_EXCEEDED	प्रदान किए गए एपीआई कुंजीपेयर के लिए एपीआई तक पहुंचने के लिए अनुमत अधिकतम अद्वितीय क्लाइंट आईपी पार हो गया है।
REQUEST_ENDED_BY_CLIENT	प्रतिक्रिया उत्पन्न होने से पहले क्लाइंट द्वारा अनुरोध समाप्त कर दिया गया था।

सीमा

दुरुपयोग को रोकने के लिए एपीआई का उपयोग कुछ सीमाओं के अधीन है। ये उपयोग सीमाएं नीचे दिखाई गई हैं और नोटिस के बिना परिवर्तन के अधीन हैं।

प्रकार	विवरण
API कुंजी प्रति खाता	3
दर सीमा	प्रति 15 मिनट अधिकतम अनुरोध 100
क्लाइंट IP पते प्रति API कुंजी	5 अद्वितीय क्लाइंट IP पते प्रति कुंजी प्रति 1440 मिनट

विस्तार विधियाँ

get

एक्सटेंशन और उनके संबंधित मूल्य निर्धारण और विवरण डेटा लौटाता है। यह विधि एक या अधिक टीएलडी विवरण पृष्ठों (उदाहरण के लिए, .com) पर प्रदर्शित डेटा को पुनः प्राप्त करने के समान है, "सबसे सस्ता मूल्य इतिहास" डेटा के अपवाद के साथ, जो इस विधि द्वारा वापस नहीं किया जाता है (ऐतिहासिक डेटा के लिए getAggregateHistory विधि देखें)।

एपीआई समापन बिंदु:https://api.tld-list.com/v1/extension/get

प्रतिक्रिया समय:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

अनुरोध पैरामीटर

कुंजी	प्रकार	विवरण
`extensions`	array of strings	निर्दिष्ट करता है कि कौन सा एक्सटेंशन पुनर्प्राप्त करना है. पूर्ववर्ती बिंदु शामिल न करें। एक्सटेंशन नाम यूनिकोड या उनके पुनीकोड समकक्ष हो सकते हैं। यदि छोड़ दिया जाता है, तो टीएलडी-सूची पर सूचीबद्ध सभी एक्सटेंशन वापस कर दिए जाएंगे। उदाहरण: `"extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]`
`includeFields`	array of strings	कुंजी नाम से वापस करने के लिए कुछ डेटा निर्दिष्ट करें. इस पैरामीटर में सबमिट नहीं की गई कुंजियों को छोड़ दिया जाएगा. डिफ़ॉल्ट रूप से, सभी उपलब्ध फ़ील्ड वापस कर दिए जाते हैं। उपलब्ध फ़ील्ड्स की सूची के लिए प्रतिसाद तालिका देखें. नेस्टेड फ़ील्ड समर्थित नहीं हैं. उदाहरण: `"includeFields": ["name", "registrars", "dnssecSupported"]`
`excludeFields`	array of strings	कुंजी नाम से बाहर करने के लिए सेटेन डेटा निर्दिष्ट करें. इस पैरामीटर में सबमिट की गई कुंजियों को छोड़ दिया जाएगा। डिफ़ॉल्ट रूप से, कोई फ़ील्ड बाहर नहीं हैं. उपलब्ध फ़ील्ड्स की सूची के लिए प्रतिसाद तालिका देखें. नेस्टेड फ़ील्ड समर्थित नहीं हैं. उदाहरण: `"excludeFields": ["available", "syntax", "sponsor"]`
`includeRegistrars`	array of strings	परिणामों में शामिल करने के लिए सक्रिय रजिस्ट्रार की स्ट्रिंग आईडी। टीएलडी-सूची पर सक्रिय रूप से सूचीबद्ध सभी रजिस्ट्रारों की आईडी की सूची प्राप्त करने के लिए getIds विधि का उपयोग करें। उदाहरण: `"includeRegistrars": ["godaddy", "porkbun", "namecheap"]`
`excludeRegistrars`	array of strings	परिणामों में शामिल करने के लिए सक्रिय रजिस्ट्रार की स्ट्रिंग आईडी। टीएलडी-सूची पर सक्रिय रूप से सूचीबद्ध सभी रजिस्ट्रारों की आईडी की सूची प्राप्त करने के लिए getIds विधि का उपयोग करें। उदाहरण: `"excludeRegistrars": ["godaddy", "porkbun", "namecheap"]`
`omitExtensionsWithoutRegistrars`	boolean	जब `true`, एक्सटेंशन जिनके परिणामों में कोई रजिस्ट्रार मूल्य निर्धारण डेटा नहीं होता है, उन्हें छोड़ दिया जाता है। डिफ़ॉल्ट रूप से, सभी एक्सटेंशन शामिल हैं। उदाहरण: `"omitExtensionsWithoutRegistrars": true`

प्रतिसाद ऑब्जेक्ट

पथ	प्रकार	विवरण
`data`	array of objects	विस्तार नामों की सरणी.
`data[].available`	object	टीएलडी चरण उपलब्धता दिनांक का उद्देश्य.
`data[].available.general`	object	ISO 8601 दिनांक समय (UTC समय क्षेत्र) जब डोमेन पंजीकरण आम जनता के लिए उपलब्ध है।
`data[].available.sunrise`	object	`start` TLD's सूर्योदय चरण का प्रतिनिधित्व करने वाली ऑब्जेक्ट ऑफ और `end` डेटटाइम श्रेणियां (जब ट्रेडमार्क मालिक लागू डोमेन के पंजीकरण के लिए आवेदन करना शुरू कर सकते हैं)। उदाहरण: __नमूना__
`data[].available.trademark`	object	`start` TLD's ट्रेडमार्क चरण का प्रतिनिधित्व करने वाली ऑब्जेक्ट और `end` डेटटाइम श्रेणियां (अवधि जब ट्रेडमार्क धारकों को ट्रेडमार्क क्लियरिंगहाउस द्वारा सूचित किया जाएगा यदि कोई डोमेन उनके चिह्न से मेल खाता हुआ पंजीकृत है)। उदाहरण: __नमूना__
`data[].available.other`	array of objects	टीएलडी के विभिन्न लॉन्च चरणों और उनकी डेटटाइम रेंज का प्रतिनिधित्व करने वाली वस्तुओं की सरणी, जैसे "लैंड रश" और "योग्य लॉन्च प्रोग्राम"। उदाहरण: __नमूना__
`data[].average`	object	शामिल रजिस्ट्रारों के लिए मूल्य प्रकार से विस्तार की औसत कीमत वाली वस्तु।
`data[].average[pricetype]`	string	[मूल्य प्रकार] के लिए एक संख्यात्मक स्ट्रिंग के रूप में एक्सटेंशन की औसत कीमत, जहां [मूल्य प्रकार] कुंजी `register`, `renewal`, `transfer`, `restore`, `whoisprivacy` है।
`data[].category`	string	टीएलडी को जिन श्रेणियों के तहत वर्गीकृत किया गया है। सरणी में प्रत्येक ऑब्जेक्ट एक श्रेणी का प्रतिनिधित्व करता है और इसमें निम्न फ़ील्ड होते हैं: `id` - पूर्णांक श्रेणी आईडी आंतरिक रूप से टीएलडी-सूची द्वारा उपयोग किया जाता है। `idstr` - वैकल्पिक स्ट्रिंग श्रेणी आईडी। `name` - अंग्रेजी में श्रेणी का नाम। `desc` - अंग्रेजी में श्रेणी विवरण। उदाहरण श्रेणी सरणी: __नमूना__
`data[].dnssecSupported`	boolean	यदि रजिस्ट्री का DNS ज़ोन DNS सुरक्षा एक्सटेंशन (DNSSEC) का समर्थन करता है।
`data[].hasPremiumDomains`	object	[मूल्य प्रकार] कुंजियों और बुलियन मानों का उद्देश्य, यह दर्शाता है कि रजिस्ट्री चुनिंदा "प्रीमियम" डोमेन नामों के लिए अधिक कीमतें वसूलती है या नहीं। उदाहरण: __नमूना__
`data[].infoUpdated`	string	ISO 8601 दिनांक समय (UTC समय क्षेत्र) जब TLD's मूल जानकारी (प्रतिबंध, उपलब्धता दिनांक, आदि) को अंतिम बार चेक और अपडेट किया गया था। नोट: नई `updated.info` दिनांक आवश्यक रूप से इंगित नहीं करती है कि कोई डेटा परिवर्तन हुआ है. यह केवल इंगित करता है कि डेटा को अंतिम बार कब चेक और सेट किया गया था।
`data[].intendedUsage`	string	पंजीकरणकर्ताओं द्वारा एक्सटेंशन का उपयोग कैसे किए जाने की उम्मीद है, इसके बारे में सामान्य जानकारी।
`data[].language`	string	आईएसओ 639-1 2 वर्ण भाषा कोड। यदि भाषा अंग्रेजी-आधारित या अज्ञात है, तो यह फ़ील्ड मौजूद नहीं होगी।
`data[].level`	integer	एक्सटेंशन के डोमेन स्तर का प्रतिनिधित्व करने वाला पूर्णांक. 1 = शीर्ष-स्तरीय डोमेन, 2 = द्वितीय-स्तरीय डोमेन, 3 = तृतीय-स्तरीय डोमेन, आदि।
`data[].localPresenceRequired`	boolean	यदि रजिस्ट्री के लिए रजिस्ट्रीकर्ता को क्षेत्र के लिए स्थानीय भौतिक पता रखने की आवश्यकता है।
`data[].median`	object	शामिल रजिस्ट्रारों के लिए मूल्य प्रकार से विस्तार की औसत कीमत वाली वस्तु।
`data[].median[pricetype]`	string	[मूल्य प्रकार] के लिए एक संख्यात्मक स्ट्रिंग के रूप में एक्सटेंशन की औसत कीमत, जहां [मूल्य प्रकार] कुंजी `register`, `renewal`, `transfer`, `restore`, `whoisprivacy` है।
`data[].name`	string	डोमेन एक्सटेंशन का यूनिकोड नाम.
`data[].nameservers`	array	रजिस्ट्री के रूट नेमसर्वर जो पंजीकृत डोमेन के आधिकारिक नाम सर्वर स्टोर करते हैं। उदाहरण नामसर्वर सरणी: __नमूना__
`data[].parentTld`	string	एक्सटेंशन का मूल शीर्ष-स्तरीय डोमेन. यदि यह एक TLD है, तो यह फ़ील्ड मौजूद नहीं होगी.
`data[].pricingUpdated`	string	ISO 8601 दिनांक समय (UTC समय क्षेत्र) जब TLD's रजिस्ट्रार मूल्य निर्धारण अंतिम बार जांचा और अद्यतन किया गया था। नोट: नई `updated.pricing` दिनांक आवश्यक रूप से इंगित नहीं करती है कि कोई डेटा परिवर्तन हुआ है. यह केवल इंगित करता है कि डेटा को अंतिम बार कब चेक और सेट किया गया था।
`data[].punycode`	string	डोमेन एक्सटेंशन का पुनीकोड नाम. केवल IDN एक्सटेंशन के लिए मौजूद है.
`data[].registerMaxYears`	integer	अधिकतम वर्ष जब किसी डोमेन को खरीद के समय पंजीकृत किया जा सकता है।
`data[].registerMinYears`	integer	न्यूनतम वर्ष जब किसी डोमेन को खरीद के समय पंजीकृत किया जा सकता है।
`data[].registrarsIncluded`	integer	लौटाए गए `registrars` सरणी में शामिल रजिस्ट्रारों की गिनती।
`data[].registrarsTotal`	integer	एक्सटेंशन बेचने वाले कुल सक्रिय रजिस्ट्रार।
`data[].registrars`	array of objects	रजिस्ट्रार मूल्य निर्धारण ऑब्जेक्ट (ओं) की सरणी जिसमें रजिस्ट्रार मूल्य निर्धारण और सुविधाएं डेटा शामिल हैं।
`data[].registryUrl`	string	टीएलडी पंजीकरण जानकारी के लिए रजिस्ट्री की आधिकारिक वेबसाइट।
`data[].renewalMinYears`	integer	न्यूनतम स्वीकार्य वर्ष जब किसी डोमेन को नवीनीकृत किया जा सकता है.
`data[].restrictions`	string	TLD's पंजीकरण प्रतिबंध और आवश्यकताओं का एक संक्षिप्त विवरण। यदि कोई प्रतिबंध नहीं हैं, तो यह फ़ील्ड मौजूद नहीं होगी
`data[].sponsor`	object	एक्सटेंशन के प्रायोजक संगठन या प्रबंधन संगठन के बारे में डेटा युक्त ऑब्जेक्ट.
`data[].sponsor.name`	string	एक्सटेंशन के ICANN अनुमोदित प्रायोजक संगठन या ccTLD प्रबंधन संगठन का नाम.
`data[].sponsor.address`	string	प्रायोजक संगठन या ccTLD प्रबंधन संगठन का भौतिक स्थान. उदाहरण पता सरणी: __नमूना__
`data[].sponsorParentCompany`	string	प्रायोजक संगठन में नियंत्रक हित का स्वामित्व रखने वाली इकाई का नाम.
`data[].romanized`	string	टीएलडी लैटिन वर्णों में स्थानांतरित हो गया। यदि भाषा अंग्रेजी-आधारित है, या अज्ञात है, तो यह फ़ील्ड मौजूद नहीं होगी।
`data[].rtl`	string	यदि एक्सटेंशन को "दाएं-से-बाएं" (यानी) से पढ़ा जाता है। अरबरिक TLDs), यह मान __true__ जाएगा। यदि इसे "बाएं-से-दाएं" से पढ़ा जाता है, तो यह मान __false__ होगा। यदि अज्ञात है, तो यह मान मौजूद नहीं होगा।
`data[].syntax`	object	एक्सटेंशन के अनुमत डोमेन नाम नियमों और प्रतिबंधों के बारे में विवरण रखने वाला ऑब्जेक्ट.
`data[].syntax.minChars`	integer	लेबल में वर्णों की न्यूनतम संख्या को पंजीकृत करने की अनुमति है.
`data[].syntax.maxChars`	integer	लेबल में वर्णों की अधिकतम संख्या को पंजीकृत करने की अनुमति है.
`data[].targetMarket`	string	टीएलडी जिन लोगों या संस्थाओं की सेवा करने का इरादा रखता है।
`data[].translation`	string	टीएलडी का अंग्रेजी अनुवाद। यदि TLD पहले से ही अंग्रेज़ी-आधारित है, या अनुवाद अज्ञात है, तो यह मान मौजूद नहीं होगा.
`data[].type`	string	TLD का प्रकार निम्न स्ट्रिंग्स में से किसी एक द्वारा पहचाना गया है: `gTLD:` जेनेरिक शीर्ष-स्तरीय डोमेन। `ccTLD:` देश-कोड शीर्ष-स्तरीय डोमेन। `grTLD:` जेनेरिक-प्रतिबंधित शीर्ष-स्तरीय डोमेन। `sTLD:` प्रायोजित शीर्ष-स्तरीय डोमेन.
`data[].wholesale`	object	मूल्य प्रकार के अनुसार विस्तार के थोक मूल्यों को दर्शाने वाली वस्तु। थोक मूल्य वे कीमतें हैं जो रजिस्ट्री द्वारा डोमेन नाम खरीद के लिए रजिस्ट्रार को लगाई जाती हैं।
`data[].whoisPrivacySupported`	boolean	यदि एक्सटेंशन WHOIS गोपनीयता सेवाओं को पंजीकरणकर्ताओं के नाम और संपर्क जानकारी को छिपाने की अनुमति देता है। यदि अज्ञात है, तो यह फ़ील्ड मौजूद नहीं होगी.
`data[].whoisServer`	boolean	रजिस्ट्री के सर्वर का होस्ट नाम जो डोमेन पंजीकरणकर्ता संपर्क जानकारी संग्रहीत करता है.

उदाहरण अनुरोध/प्रतिसाद

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\" : [
      '{'
         \"average\" : '{'
            \"register\" : \"7.63\",
            \"renewal\" : \"13.63\",
            \"transfer\" : \"9.63\"
         '}',
         \"clicks\" : 226,
         \"dnssecSupported\" : true,
         \"hasPremiumDomains\" : '{'
            \"register\" : false,
            \"renewal\" : false
         '}',
         \"infoUpdated\" : \"2023-02-04T11:05:09\",
         \"level\" : 1,
         \"localPresenceRequired\" : false,
         \"median\" : '{'
            \"register\" : \"3.17\",
            \"renewal\" : \"20.17\",
            \"transfer\" : \"8.17\"
         '}',
         \"name\" : \"com\",
         \"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\"
            '}',
            '{'
               \"host\" : \"c.gtld-servers.net\",
               \"ipv4\" : \"192.26.92.30\",
               \"ipv6\" : \"2001:503:83eb:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"d.gtld-servers.net\",
               \"ipv4\" : \"192.31.80.30\",
               \"ipv6\" : \"2001:500:856e:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"e.gtld-servers.net\",
               \"ipv4\" : \"192.12.94.30\",
               \"ipv6\" : \"2001:502:1ca1:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"f.gtld-servers.net\",
               \"ipv4\" : \"192.35.51.30\",
               \"ipv6\" : \"2001:503:d414:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"g.gtld-servers.net\",
               \"ipv4\" : \"192.42.93.30\",
               \"ipv6\" : \"2001:503:eea3:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"h.gtld-servers.net\",
               \"ipv4\" : \"192.54.112.30\",
               \"ipv6\" : \"2001:502:8cc:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"i.gtld-servers.net\",
               \"ipv4\" : \"192.43.172.30\",
               \"ipv6\" : \"2001:503:39c1:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"j.gtld-servers.net\",
               \"ipv4\" : \"192.48.79.30\",
               \"ipv6\" : \"2001:502:7094:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"k.gtld-servers.net\",
               \"ipv4\" : \"192.52.178.30\",
               \"ipv6\" : \"2001:503:d2d:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"l.gtld-servers.net\",
               \"ipv4\" : \"192.41.162.30\",
               \"ipv6\" : \"2001:500:d937:0:0:0:0:30\"
            '}',
            '{'
               \"host\" : \"m.gtld-servers.net\",
               \"ipv4\" : \"192.55.83.30\",
               \"ipv6\" : \"2001:501:b1f9:0:0:0:0:30\"
            '}'
         ],
         \"pricingUpdated\" : \"2023-02-04T11:04:33\",
         \"registerMaxYears\" : 10,
         \"registerMinYears\" : 1,
         \"registrars\" : [
            '{'
               \"currency\" : \"USD\",
               \"freeFeatures\" : [
                  '{'
                     \"name\" : \"dns\"
                  '}',
                  '{'
                     \"name\" : \"whois-privacy\"
                  '}'
               ],
               \"id\" : \"godaddy\",
               \"name\" : \"GoDaddy\",
               \"notes\" : '{'
                  \"feeIcann\" : '{'
                     \"addedToListPrice\" : true,
                     \"amount\" : \"0.18\",
                     \"pricetype\" : [
                        \"register\",
                        \"renewal\",
                        \"transfer\"
                     ]
                  '}',
                  \"feeTax\" : [
                     '{'
                        \"addedToListPrice\" : false,
                        \"amountRate\" : \"~\",
                        \"amountRateType\" : \"percent-varies-by-location\",
                        \"appliesToCustomers\" : [
                           \"eu\"
                        ],
                        \"type\" : \"vat\"
                     '}',
                     '{'
                        \"addedToListPrice\" : false,
                        \"amountRate\" : \"15\",
                        \"amountRateType\" : \"percent\",
                        \"appliesToCustomers\" : [
                           \"in\"
                        ],
                        \"type\" : \"gst\"
                     '}',
                     '{'
                        \"addedToListPrice\" : false,
                        \"amountRate\" : \"10\",
                        \"amountRateType\" : \"percent\",
                        \"appliesToCustomers\" : [
                           \"au\"
                        ],
                        \"type\" : \"gst\"
                     '}'
                  ]
               '}',
               \"prices\" : '{'
                  \"register\" : \"3.17\",
                  \"renewal\" : \"20.17\",
                  \"transfer\" : \"8.17\",
                  \"whoisPrivacy\" : \"0.00\"
               '}',
               \"pricesOriginal\" : '{'
                  \"register\" : \"10.18\"
               '}',
               \"promos\" : [
                  '{'
                     \"amount\" : \"2.99\",
                     \"code\" : \"GDD2dom\",
                     \"pricetype\" : [
                        \"register\"
                     ],
                     \"start\" : \"2023-01-01T00:00:00\",
                     \"type\" : \"price\"
                  '}'
               ],
               \"terms\" : '{'
                  \"limitPerCustomer\" : '{'
                     \"count\" : 1,
                     \"pricetype\" : [
                        \"register\"
                     ]
                  '}'
               '}',
               \"threeYearValueScore\" : \"5.76\"
            '}',
            '{'
               \"currency\" : \"USD\",
               \"freeFeatures\" : [
                  '{'
                     \"name\" : \"whois-privacy\"
                  '}',
                  '{'
                     \"name\" : \"dns\"
                  '}'
               ],
               \"id\" : \"epik\",
               \"name\" : \"Epik\",
               \"prices\" : '{'
                  \"register\" : \"9.99\",
                  \"renewal\" : \"10.99\",
                  \"restore\" : \"90.00\",
                  \"transfer\" : \"9.99\",
                  \"whoisPrivacy\" : \"0.00\"
               '}',
               \"threeYearValueScore\" : \"8.29\"
            '}',
            '{'
               \"currency\" : \"USD\",
               \"freeFeatures\" : [
                  '{'
                     \"name\" : \"whois-privacy\"
                  '}',
                  '{'
                     \"name\" : \"dns\"
                  '}',
                  '{'
                     \"name\" : \"email-forward\"
                  '}',
                  '{'
                     \"name\" : \"ssl-cert\"
                  '}'
               ],
               \"id\" : \"porkbun\",
               \"name\" : \"Porkbun\",
               \"prices\" : '{'
                  \"register\" : \"8.73\",
                  \"renewal\" : \"9.73\",
                  \"transfer\" : \"9.73\",
                  \"whoisPrivacy\" : \"0.00\"
               '}',
               \"pricesOriginal\" : '{'
                  \"register\" : \"9.73\"
               '}',
               \"promos\" : [
                  '{'
                     \"amount\" : \"1.00\",
                     \"code\" : \"AWESOMENESS\",
                     \"pricetype\" : [
                        \"register\"
                     ],
                     \"type\" : \"discount\"
                  '}'
               ],
               \"terms\" : '{'
                  \"limitPerCustomer\" : '{'
                     \"count\" : 1,
                     \"pricetype\" : [
                        \"register\"
                     ]
                  '}'
               '}',
               \"threeYearValueScore\" : \"16.03\"
            '}'
         ],
         \"registryUrl\" : \"http://www.verisigninc.com\",
         \"renewalMinYears\" : 1,
         \"rtl\" : false,
         \"sponsor\" : '{'
            \"address\" : [
               \"12061 Bluemont Way\",
               \"Reston Virginia 20190\",
               \"United States\"
            ],
            \"name\" : \"VeriSign Global Registry Services\"
         '}',
         \"syntax\" : '{'
            \"maxChars\" : 63,
            \"minChars\" : 2
         '}',
         \"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

सभी एक्सटेंशन नाम लौटाता है।

एपीआई समापन बिंदु:https://api.tld-list.com/v1/extension/getNames

प्रतिक्रिया समय:~1 second

अनुरोध पैरामीटर

कुंजी	प्रकार	आवश्यक	विवरण
`omitExtensionsWithoutRegistrars`	boolean		जब `true`, एक्सटेंशन जिनके परिणामों में कोई रजिस्ट्रार मूल्य निर्धारण डेटा नहीं होता है, उन्हें छोड़ दिया जाता है। डिफ़ॉल्ट है `false`।
`wantPunycode`	boolean		सभी लौटाए गए आईडीएन एक्सटेंशन को यूनिकोड के बजाय पुनीकोड के रूप में एन्कोड करें। डिफ़ॉल्ट है `false.`

प्रतिसाद ऑब्जेक्ट

पथ	प्रकार	विवरण
`data`	array 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\",
      \"6g.in\",
      \"aaa.pro\",
      \"abc.br\",
      \"abkhazia.su\",
      \"abo.pa\",
      \"abogado\",
      \"abr.it\",
      \"abruzzo.it\",
      \"abudhabi\",
      ...
      \"xn--3bst00m\",
      \"xn--jvr189m\",
      \"xn--imr513n\",
      \"xn--j6w193g\",
      \"xn--t60b56a\",
      \"xn--mk1bu44c\",
      \"xn--3e0b707e\"
   ],
   \"errors\" : [],
   \"seconds\" : 0.697,
   \"status\" : \"SUCCESS\"
'}'

getCheapestRegistrar

प्रदाता, उनके मूल्य निर्धारण, औसत मूल्य और प्रति डोमेन एक्सटेंशन औसत मूल्य लौटाता है। एक्सटेंशन जो किसी भी रजिस्ट्रार द्वारा नहीं बेचे जाते हैं, उन्हें वापस नहीं किया जाता है।

एपीआई समापन बिंदु:https://api.tld-list.com/v1/extension/getCheapestRegistrar

प्रतिक्रिया समय:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

अनुरोध पैरामीटर

कुंजी	प्रकार	विवरण
`pricetypes`	array of strings	पुनर्प्राप्त करने के लिए मूल्य निर्धारण के प्रकार निर्दिष्ट करता है। यदि छोड़ दिया जाता है, तो सभी 3 मूल्य प्रकार (`register`, `renewal`, `transfer`) वापस कर दिए जाते हैं। उदाहरण: `"pricetypes": ["register", "transfer"]`
`extensions`	array of strings	निर्दिष्ट करता है कि कौन सा एक्सटेंशन पुनर्प्राप्त करना है. पूर्ववर्ती बिंदु शामिल न करें। एक्सटेंशन नाम यूनिकोड या उनके पुनीकोड समकक्ष हो सकते हैं। यदि छोड़ दिया जाता है, तो टीएलडी-सूची पर सूचीबद्ध सभी एक्सटेंशन वापस कर दिए जाएंगे। उदाहरण: `"extensions": ["com", "io", "co.uk", "移动", "xn--p1ai"]`
`includeRegistrars`	array of strings	सबसे सस्ता मूल्य निर्धारण और कुल गणना निर्धारित करते समय सक्रिय रजिस्ट्रार की स्ट्रिंग आईडी शामिल होती है। इस पैरामीटर में निर्दिष्ट नहीं किए गए रजिस्ट्रार ों पर ध्यान नहीं दिया जाएगा। टीएलडी-सूची पर सक्रिय रूप से सूचीबद्ध सभी रजिस्ट्रारों की सूची प्राप्त करने के लिए getIds विधि का उपयोग करें।यदि इस पैरामीटर को छोड़ दिया जाता है, तो टीएलडी-सूची पर सक्रिय रूप से सूचीबद्ध सभी रजिस्ट्रारों पर विचार किया जाएगा। उदाहरण: `"includeRegistrars": ["godaddy", "porkbun", "namecheap"]`
`excludeRegistrars`	array of strings	सबसे सस्ता मूल्य निर्धारण और कुल गणना निर्धारित करते समय सक्रिय रजिस्ट्रार की स्ट्रिंग आईडी को बाहर करना। इस पैरामीटर में निर्दिष्ट नहीं किए गए सभी रजिस्ट्रारों पर विचार किया जाएगा। टीएलडी-सूची पर सक्रिय रूप से सूचीबद्ध सभी रजिस्ट्रारों की सूची प्राप्त करने के लिए getIds विधि का उपयोग करें।यदि इस पैरामीटर को छोड़ दिया जाता है, तो किसी भी रजिस्ट्रार को अनदेखा नहीं किया जाएगा। उदाहरण: `"excludeRegistrars": ["godaddy", "porkbun", "namecheap"]`
`omitExtensionsWithoutRegistrars`	boolean	जब `true`, एक्सटेंशन जिनके परिणामों में कोई रजिस्ट्रार मूल्य निर्धारण डेटा नहीं होता है, उन्हें छोड़ दिया जाता है। यह स्थिति तब होती है जब पारित `excludeRegistrars` और / या `includeRegistrars` मापदंडों ने एक एक्सटेंशन का कारण बना दिया है जिसमें आम तौर पर रजिस्ट्रार मूल्य निर्धारण डेटा होता है जिसमें कोई मिलान रजिस्ट्रार मूल्य निर्धारण डेटा नहीं होता है। ये एक्सटेंशन डिफ़ॉल्ट रूप से शामिल हैं, लेकिन उनके मूल्य निर्धारण डेटा के लिए खाली सरणी के साथ। परिणामों `true` से इन एक्सटेंशन को हटाने के लिए सेट करें। उदाहरण: `"omitExtensionsWithoutRegistrars": true`

प्रतिसाद ऑब्जेक्ट

पथ	प्रकार	विवरण
`data`	array of objects	ऑब्जेक्ट्स की सरणी, प्रत्येक एक डोमेन एक्सटेंशन का प्रतिनिधित्व करती है।
`data[].name`	string	डोमेन एक्सटेंशन का यूनिकोड नाम.
`data[].punycode`	string	डोमेन एक्सटेंशन का पुनीकोड नाम. केवल IDN एक्सटेंशन के लिए मौजूद है.
`data[].currency`	string	मूल्य निर्धारण डेटा का तीन-अक्षर आईएसओ 4217 मुद्रा कोड। यह मान वर्तमान में केवल `USD`है।
`data[].registrarsIncluded`	number	लौटाए गए मूल्य निर्धारण डेटा में शामिल रजिस्ट्रारों की गिनती।
`data[].average`	object	शामिल रजिस्ट्रारों के लिए मूल्य प्रकार से विस्तार की औसत कीमत वाली वस्तु।
`data[].average[pricetype]`	string	[मूल्य प्रकार] के लिए एक संख्यात्मक स्ट्रिंग के रूप में एक्सटेंशन की औसत कीमत, जहां [मूल्य प्रकार] कुंजी `register`, `renewal`, `transfer` है।
`data[].median`	object	शामिल रजिस्ट्रारों के लिए मूल्य प्रकार से विस्तार की औसत कीमत वाली वस्तु।
`data[].median[pricetype]`	string	[मूल्य प्रकार] के लिए एक संख्यात्मक स्ट्रिंग के रूप में एक्सटेंशन की औसत कीमत, जहां [मूल्य प्रकार] कुंजी `register`, `renewal`, `transfer` है।
`data[].cheapest`	object	मूल्य प्रकार द्वारा एक्सटेंशन के लिए सबसे सस्ता रजिस्ट्रार युक्त ऑब्जेक्ट।
`data[].cheapest[pricetype]`	array of objects	रजिस्ट्रारप्राइसिंग ऑब्जेक्ट (ओं) की सरणी जिसमें [मूल्य प्रकार] द्वारा सबसे सस्ता रजिस्ट्रार (ओं) होता है, जहां [मूल्य प्रकार] कुंजी `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\", \"namesilo\", \"netim\"], \"extensions\": [\"com\", \"co.uk\"]'}''

'{'
   \"data\" : [
      '{'
         \"average\" : '{'
            \"register\" : \"7.85\",
            \"renewal\" : \"10.25\",
            \"transfer\" : \"11.99\"
         '}',
         \"cheapest\" : '{'
            \"register\" : [
               '{'
                  \"currency\" : \"USD\",
                  \"freeFeatures\" : [
                     '{'
                        \"name\" : \"dns\"
                     '}',
                     '{'
                        \"name\" : \"email-forward\"
                     '}',
                     '{'
                        \"name\" : \"ssl-cert\"
                     '}'
                  ],
                  \"id\" : \"porkbun\",
                  \"name\" : \"Porkbun\",
                  \"price\" : \"4.96\",
                  \"priceOriginal\" : \"5.96\",
                  \"prices\" : '{'
                     \"register\" : \"4.96\",
                     \"renewal\" : \"5.96\"
                  '}',
                  \"pricesOriginal\" : '{'
                     \"register\" : \"5.96\"
                  '}',
                  \"pricetype\" : \"register\",
                  \"promo\" : '{'
                     \"amount\" : \"1.00\",
                     \"code\" : \"AWESOMENESS\",
                     \"type\" : \"discount\"
                  '}',
                  \"promos\" : [
                     '{'
                        \"amount\" : \"1.00\",
                        \"code\" : \"AWESOMENESS\",
                        \"type\" : \"discount\"
                     '}'
                  ],
                  \"terms\" : '{'
                     \"limitPerCustomer\" : '{'
                        \"count\" : 1
                     '}'
                  '}',
                  \"threeYearValueScore\" : \"18.36\"
               '}'
            ],
            \"renewal\" : [
               '{'
                  \"currency\" : \"USD\",
                  \"freeFeatures\" : [
                     '{'
                        \"name\" : \"dns\"
                     '}',
                     '{'
                        \"name\" : \"email-forward\"
                     '}',
                     '{'
                        \"name\" : \"ssl-cert\"
                     '}'
                  ],
                  \"id\" : \"porkbun\",
                  \"name\" : \"Porkbun\",
                  \"price\" : \"5.96\",
                  \"prices\" : '{'
                     \"register\" : \"4.96\",
                     \"renewal\" : \"5.96\"
                  '}',
                  \"pricetype\" : \"renewal\",
                  \"threeYearValueScore\" : \"18.36\"
               '}'
            ],
            \"transfer\" : [
               '{'
                  \"currency\" : \"USD\",
                  \"freeFeatures\" : [
                     '{'
                        \"name\" : \"dns\"
                     '}'
                  ],
                  \"id\" : \"godaddy\",
                  \"name\" : \"GoDaddy\",
                  \"notes\" : '{'
                     \"feeTax\" : [
                        '{'
                           \"addedToListPrice\" : false,
                           \"amountRate\" : \"~\",
                           \"amountRateType\" : \"percent-varies-by-location\",
                           \"appliesToCustomers\" : [
                              \"eu\"
                           ],
                           \"type\" : \"vat\"
                        '}',
                        '{'
                           \"addedToListPrice\" : false,
                           \"amountRate\" : \"15\",
                           \"amountRateType\" : \"percent\",
                           \"appliesToCustomers\" : [
                              \"in\"
                           ],
                           \"type\" : \"gst\"
                        '}',
                        '{'
                           \"addedToListPrice\" : false,
                           \"amountRate\" : \"10\",
                           \"amountRateType\" : \"percent\",
                           \"appliesToCustomers\" : [
                              \"au\"
                           ],
                           \"type\" : \"gst\"
                        '}'
                     ]
                  '}',
                  \"price\" : \"11.99\",
                  \"prices\" : '{'
                     \"register\" : \"6.49\",
                     \"renewal\" : \"11.99\",
                     \"transfer\" : \"11.99\"
                  '}',
                  \"pricetype\" : \"transfer\",
                  \"threeYearValueScore\" : \"3.46\"
               '}'
            ]
         '}',
         \"currency\" : \"USD\",
         \"median\" : '{'
            \"register\" : \"6.48\",
            \"renewal\" : \"10.78\",
            \"transfer\" : \"11.99\"
         '}',
         \"name\" : \"co.uk\",
         \"registrarsIncluded\" : 4,
         \"registrarsTotal\" : 47
      '}',
      '{'
         \"average\" : '{'
            \"register\" : \"8.90\",
            \"renewal\" : \"14.10\",
            \"transfer\" : \"9.30\"
         '}',
         \"cheapest\" : '{'
            \"register\" : [
               '{'
                  \"currency\" : \"USD\",
                  \"freeFeatures\" : [
                     '{'
                        \"name\" : \"dns\"
                     '}',
                     '{'
                        \"name\" : \"whois-privacy\"
                     '}'
                  ],
                  \"id\" : \"godaddy\",
                  \"name\" : \"GoDaddy\",
                  \"notes\" : '{'
                     \"feeIcann\" : '{'
                        \"addedToListPrice\" : true,
                        \"amount\" : \"0.18\"
                     '}',
                     \"feeTax\" : [
                        '{'
                           \"addedToListPrice\" : false,
                           \"amountRate\" : \"~\",
                           \"amountRateType\" : \"percent-varies-by-location\",
                           \"appliesToCustomers\" : [
                              \"eu\"
                           ],
                           \"type\" : \"vat\"
                        '}',
                        '{'
                           \"addedToListPrice\" : false,
                           \"amountRate\" : \"15\",
                           \"amountRateType\" : \"percent\",
                           \"appliesToCustomers\" : [
                              \"in\"
                           ],
                           \"type\" : \"gst\"
                        '}',
                        '{'
                           \"addedToListPrice\" : false,
                           \"amountRate\" : \"10\",
                           \"amountRateType\" : \"percent\",
                           \"appliesToCustomers\" : [
                              \"au\"
                           ],
                           \"type\" : \"gst\"
                        '}'
                     ]
                  '}',
                  \"price\" : \"3.17\",
                  \"priceOriginal\" : \"10.18\",
                  \"prices\" : '{'
                     \"register\" : \"3.17\",
                     \"renewal\" : \"20.17\",
                     \"transfer\" : \"8.17\",
                     \"whoisPrivacy\" : \"0.00\"
                  '}',
                  \"pricesOriginal\" : '{'
                     \"register\" : \"10.18\"
                  '}',
                  \"pricetype\" : \"register\",
                  \"promo\" : '{'
                     \"amount\" : \"2.99\",
                     \"code\" : \"GDD2dom\",
                     \"start\" : \"2023-01-01T00:00:00\",
                     \"type\" : \"price\"
                  '}',
                  \"promos\" : [
                     '{'
                        \"amount\" : \"2.99\",
                        \"code\" : \"GDD2dom\",
                        \"start\" : \"2023-01-01T00:00:00\",
                        \"type\" : \"price\"
                     '}'
                  ],
                  \"terms\" : '{'
                     \"limitPerCustomer\" : '{'
                        \"count\" : 1
                     '}'
                  '}',
                  \"threeYearValueScore\" : \"5.76\"
               '}'
            ],
            \"renewal\" : [
               '{'
                  \"currency\" : \"USD\",
                  \"freeFeatures\" : [
                     '{'
                        \"name\" : \"whois-privacy\"
                     '}',
                     '{'
                        \"name\" : \"dns\"
                     '}',
                     '{'
                        \"name\" : \"email-forward\"
                     '}',
                     '{'
                        \"name\" : \"ssl-cert\"
                     '}'
                  ],
                  \"id\" : \"porkbun\",
                  \"name\" : \"Porkbun\",
                  \"price\" : \"9.73\",
                  \"prices\" : '{'
                     \"register\" : \"8.73\",
                     \"renewal\" : \"9.73\",
                     \"transfer\" : \"9.73\",
                     \"whoisPrivacy\" : \"0.00\"
                  '}',
                  \"pricetype\" : \"renewal\",
                  \"threeYearValueScore\" : \"16.03\"
               '}'
            ],
            \"transfer\" : [
               '{'
                  \"currency\" : \"USD\",
                  \"freeFeatures\" : [
                     '{'
                        \"name\" : \"dns\"
                     '}',
                     '{'
                        \"name\" : \"whois-privacy\"
                     '}',
                     '{'
                        \"name\" : \"email-forward\"
                     '}'
                  ],
                  \"id\" : \"namecheap\",
                  \"name\" : \"Namecheap\",
                  \"notes\" : '{'
                     \"feeIcann\" : '{'
                        \"addedToListPrice\" : true,
                        \"amount\" : \"0.18\"
                     '}'
                  '}',
                  \"price\" : \"7.16\",
                  \"prices\" : '{'
                     \"register\" : \"6.16\",
                     \"renewal\" : \"14.16\",
                     \"restore\" : \"13.98\",
                     \"transfer\" : \"7.16\",
                     \"whoisPrivacy\" : \"0.00\"
                  '}',
                  \"pricetype\" : \"transfer\",
                  \"terms\" : '{'
                     \"limitPerCustomer\" : '{'
                        \"count\" : 1
                     '}'
                  '}',
                  \"threeYearValueScore\" : \"10.15\"
               '}'
            ]
         '}',
         \"currency\" : \"USD\",
         \"median\" : '{'
            \"register\" : \"10.95\",
            \"renewal\" : \"10.95\",
            \"transfer\" : \"9.95\"
         '}',
         \"name\" : \"com\",
         \"registrarsIncluded\" : 5,
         \"registrarsTotal\" : 59
      '}'
   ],
   \"errors\" : [],
   \"seconds\" : 0.126,
   \"status\" : \"SUCCESS\"
'}'

रजिस्ट्रार विधियाँ

getIds

सभी रजिस्ट्रार आईडी लौटाता है, जिनमें से प्रत्येक विशिष्ट रूप से टीएलडी-सूची पर सक्रिय रूप से सूचीबद्ध रजिस्ट्रार की पहचान करता है।

एपीआई समापन बिंदु:https://api.tld-list.com/v1/registrar/getIds

प्रतिक्रिया समय:< 1 second

अनुरोध पैरामीटर

कोई नहीं

प्रतिसाद ऑब्जेक्ट

पथ	प्रकार	विवरण
`data`	array of strings	स्ट्रिंग रजिस्ट्रार आईडी की सरणी।

उदाहरण अनुरोध/प्रतिसाद

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\"
'}'

API

एपीआई v1 प्रलेखन

सिंहावलोकन

प्रमाणीकरण

Example authentication parameters

प्रतिक्रिया

उदाहरण विफल प्रतिसाद ऑब्जेक्ट जो त्रुटियों के साथ विफल रहा

उदाहरण सफल प्रतिसाद ऑब्जेक्ट

सामान्य प्रतिक्रिया ऑब्जेक्ट्स

RegistrarPricing

RegistrarPromo

त्रुटि कोड

सीमा

विस्तार विधियाँ

get

अनुरोध पैरामीटर

प्रतिसाद ऑब्जेक्ट

उदाहरण अनुरोध/प्रतिसाद

getNames

अनुरोध पैरामीटर

प्रतिसाद ऑब्जेक्ट

उदाहरण अनुरोध/प्रतिसाद

getCheapestRegistrar

अनुरोध पैरामीटर

प्रतिसाद ऑब्जेक्ट

उदाहरण अनुरोध/प्रतिसाद

रजिस्ट्रार विधियाँ

getIds

अनुरोध पैरामीटर

प्रतिसाद ऑब्जेक्ट

उदाहरण अनुरोध/प्रतिसाद

प्रतीक्षा सूची में शामिल हों