API

Предупреждение: В настоящее время API находится в стадии разработки и подлежит дополнению: в будущем могут быть добавлены новые методы и параметры. Любые внесенные изменения будут сохранять обратную совместимость с существующей функциональностью.

Обзор

API TLD-List v1 может быть использован для получения данных, отображаемых на TLD-List, из его живой базы данных.

API принимает HTTP POST'ы, содержащие JSON-данные, и отвечает JSON-данными. Требования для всех запросов методов API:

• Запросы должны выполняться с использованием метода HTTP POST
• Запросы должны иметь JSON-тело, содержащее действительную пару открытых и закрытых API-ключей для аутентификации
• Запросы должны содержать заголовок: Content-Type: application/json

Параметры передаются API в виде ключей/значений в теле запроса в кодировке JSON.

Базовый URL для всех API-запросов составляет:https://api.tld-list.com/v1

Аутентификация

Аутентификация осуществляется путем передачи открытого API-ключа и закрытого API-ключа в теле JSON, размещенном в URL-адресе метода. Все вызовы API должны содержать действительную пару API-ключей. Пары ключей API могут быть сгенерированы в Вашей учетной записи TLD-List на вкладке API.

Посетите раздел Учетная запись > API, чтобы создать ключи API.

Ключи API передаются в теле JSON-запроса с помощью параметров apiKeyPublic (Ваш открытый ключ) и apiKeyPrivate (Ваш закрытый ключ).

Example authentication parameters

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

Ответ

Все успешные ответы API будут иметь код состояния HTTP 200 SUCCESS и закодированное в JSON тело. Любой другой код состояния HTTP в ответе означает, что запрос не прошел и произошла ошибка.

Объекты ответа JSON, возвращаемые API, будут иметь следующую структуру:

Пример объекта неудачного ответа с ошибками

'{'
   \"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), включая дополнительные детали, такие как специальные условия, сборы, налоги и рекламные акции.

'{'
    \"register\": \"8.73\",
    \"renewal\": \"9.73\",
    \"transfer\": \"9.73\",
    \"whoisPrivacy\": \"0.00\"
'}'

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

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

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

'{'
    \"feeTax\": [
        '{'
            \"addedToListPrice\": false,
            \"appliesToCustomers\": [
                \"eu\",
                \"us\",
                \"in\"
            ],
            \"amountRateType\": \"percent\",
            \"amountRate\": \"13\",
            \"type\": \"hst\"
        '}',
        '{'
            \"addedToListPrice\": false,
            \"appliesToCustomers\": [
                \"ca\"
            ],
            \"amountRateType\": \"percent\",
            \"amountRate\": \"5\",
            \"type\": \"gst\"
        '}'
    ]
'}'

'{'
    \"feePayment\": '{'
        \"addedToListPrice\": false,
        \"amountRate\": \"~\",
        \"amountRateMin\": \"0.9\",
        \"amountRateMax\": \"20\",
        \"amountRateType\": \"percent-varies-by-method\"
    '}'
'}'

'{'
    \"currencyExchangeRate\": '{'
        \"base\": \"GBP\",
        \"quote\": \"USD\",
        \"rate\": \"1.2482\"
    '}'
'}'

[
    '{'
        \"name\": \"dns\"
    '}',
    '{'
        \"name\": \"whois-privacy\"
    '}',
    '{'
        \"name\": \"email-account\",
        \"count\": 5
    '}',
    '{'
        \"name\": \"ssl-cert\",
        \"duration\": 365
    '}'
]

RegistrarPromo

Описывает активную рекламную акцию, предлагаемую регистратором. Пример:

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

Коды ошибок

При отказе запроса объект JSON-ответа может содержать один или несколько объектов ошибок, которые описывают, что именно пошло не так. Ниже приведен неполный список идентифицирующих кодов ошибок, которые могут быть установлены в поле кода объекта ошибки.

Ограничения

Для предотвращения злоупотреблений на использование API накладываются определенные ограничения. Эти ограничения приведены ниже и могут быть изменены без предварительного уведомления.

Методы расширения

get

Возвращает расширения и связанные с ними данные о ценах и деталях. Этот метод схож с получением данных, отображаемых на одной или нескольких страницах с подробной информацией о ДВУ (например, .com), за исключением данных "История самых дешевых цен", которые не возвращаются этим методом (для получения исторических данных см. метод getAggregateHistory ).

Конечная точка API:https://api.tld-list.com/v1/extension/get

Время отклика:~12 seconds for all extensions, ~6 seconds < 2000 extensions, ~2 seconds < 100 extensions

Параметры запроса

Объект реагирования

'{'
    \"sunrise\": '{'
        \"start\": \"2017-06-19T00:00:00.000Z\",
        \"end\": \"2017-08-21T00:00:00.000Z\"
    '}'
'}'

'{'
    \"trademark\": '{'
        \"start\": \"2019-06-18T00:00:00.000Z\",
        \"end\": \"2020-09-21T00:00:00.000Z\"
    '}'
'}'

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

'{'
    \"average\": '{'
        \"register\": \"7.63\",
        \"renewal\": \"13.63\",
        \"transfer\": \"9.63\"
    '}'
'}'

[
    '{'
        \"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.\"
    '}'
]

'{'
    \"hasPremiumDomains\": '{'
        \"register\": false,
        \"renewal\": false
    '}'
'}'

'{'
    \"median\": '{'
        \"register\": \"3.17\",
        \"renewal\": \"20.17\",
        \"transfer\": \"8.17\"
    '}'
'}'

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

'{'
    \"sponsor\": '{'
        \"address\": [
            \"Minerva House\",
            \"Edmund Halley Road\",
            \"Oxford Science Park\",
            \"Oxford OX4 4DQ\",
            \"United Kingdom\"
        ]
    '}'
'}'

'{'
    \"wholesale\": '{'
        \"register\": \"8.97\",
        \"renewal\": \"8.97\",
        \"transfer\": \"8.97\"
    '}'
'}'

Пример запроса/ответа

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

Возвращает все имена расширений.

Конечная точка API:https://api.tld-list.com/v1/extension/getNames

Время отклика:~1 second

Параметры запроса

Объект реагирования

Пример запроса/ответа

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

Возвращает данные о самых дешевых регистраторах/провайдерах, их ценах, медианной цене и средней цене на одно доменное расширение. Расширения, которые не продаются ни одним регистратором, не возвращаются.

Конечная точка API:https://api.tld-list.com/v1/extension/getCheapestRegistrar

Время отклика:~8 seconds for all extensions, ~4 seconds < 2000 extensions, ~1 second < 100 extensions

Параметры запроса

Объект реагирования

Пример запроса/ответа

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

Возвращает все идентификаторы регистраторов, каждый из которых уникальным образом идентифицирует регистратора, активно зарегистрированного на сайте TLD-List.

Конечная точка API:https://api.tld-list.com/v1/registrar/getIds

Время отклика:< 1 second

Параметры запроса

Нет

Объект реагирования

Пример запроса/ответа

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