fqdn, tld, 2ld extractor is a tool to extract fqdn, tld, 2ld of a domain or an url based on public suffix list. Also an idna encode is supported (ascii and unicode encoding) for the result. All the success call will resoponse with 200 status code

Endpoints

Get /url/fqdn/{url}

get fqdn, tld, 2ld of a valid url
Example 1: a valid url (encoded)
request:

curl -X GET /url/fqdn/http%3A%2F%2Fwww.example.co.uk

response:

{"TLD":"co.uk","SLD":"example","FQDN":"www.example.co.uk"}

Example 2: a valid url (not encoded)
request:

curl -X GET /url/fqdn/http://www.example.co.uk

response:

{"TLD":"co.uk","SLD":"example","FQDN":"www.example.co.uk"}

Example 3: a valid url with non ascii character (an idna ascii encode is enable by default)
request:

curl -X GET /url/fqdn/http://見.香港

response:

{"TLD":"xn--j6w193g","SLD":"xn--nw2a","FQDN":"xn--nw2a.xn--j6w193g"}

Example 4: a valid url with non ascii character (use idna unicode encode)
request:

curl -X GET /url/fqdn/http://xn--nw2a.xn--j6w193g?idna=unicode

response:

{"TLD":"香港","SLD":"見","FQDN":"見.香港"}

Get /url/domain/{url}

get domain name of a valid url
Example 1: a valid url
request:

curl -X GET /url/domain/http%3A%2F%2Fwww.example.co.uk

response:

{"Domain":"example.co.uk"}

Get /fqdn/{name}

get fqdn, tld, 2ld of domain
Example 1: a valid domain
request:

curl -X GET /fqdn/www.example.co.uk

response:

{"TLD":"co.uk","SLD":"example","FQDN":"www.example.co.uk"}

Get /domain/{name}

get domain name of domain
Example 1: a valid domain
request:

curl -X GET /domain/www.example.co.uk

response:

{"Domain":"example.co.uk"}

Error Message

request:

curl -X GET /domain/www.example.co.uk?idna=wrong_value

response:

{"message":"unknown idna encode: wrong_value, currently only support ascii, unicode"}

Error code

• 400: Bad Request
• 500: Internal Server Error