{"openapi":"3.1.0","info":{"title":"Domain Parser API","version":"1.0.0","description":"Parse any hostname or URL with the Public Suffix List. Split a domain into its subdomain, registrable domain (eTLD+1) and public suffix (eTLD), or fetch just the suffix or just the registrable domain. Handles full URLs, internationalized (punycode) domains, IP addresses, multi-level suffixes like co.uk and com.au, and — when you ask for it — private suffixes such as github.io and s3 buckets. Built on an always-current Public Suffix List and served entirely in-memory, so responses are instant and the service is always available. Ideal for cookie and domain scoping, analytics attribution, email and link validation, security and anti-abuse, and devops tooling.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/domain-api","description":"oanor gateway"}],"tags":[{"name":"Domain"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/parse":{"get":{"operationId":"get_v1_parse","tags":["Domain"],"summary":"Full domain breakdown","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"Hostname or URL","schema":{"type":"string"},"example":"www.example.co.uk"},{"name":"private","in":"query","required":false,"description":"Treat private suffixes (github.io, etc.) as public (true/false)","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"input":"www.example.co.uk","is_ip":false,"domain":"example.co.uk","hostname":"www.example.co.uk","is_icann":true,"subdomain":"www","is_private":false,"public_suffix":"co.uk","domain_without_suffix":"example","parse_private_domains":false},"meta":{"timestamp":"2026-05-30T18:16:48.621Z","request_id":"4d193905-3982-4d6f-8744-1542b8cd8dca"},"status":"ok","message":"Domain parsed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/registrable":{"get":{"operationId":"get_v1_registrable","tags":["Domain"],"summary":"Registrable domain (eTLD+1)","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"Hostname or URL","schema":{"type":"string"},"example":"a.b.c.example.org"},{"name":"private","in":"query","required":false,"description":"Treat private suffixes (github.io, etc.) as public (true/false)","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"input":"a.b.c.example.org","hostname":"a.b.c.example.org","subdomain":"a.b.c","public_suffix":"org","registrable_domain":"example.org"},"meta":{"timestamp":"2026-05-30T18:16:48.709Z","request_id":"7f4e9b7e-9cc2-490a-aa02-c8fec473eb82"},"status":"ok","message":"Registrable domain retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/suffix":{"get":{"operationId":"get_v1_suffix","tags":["Domain"],"summary":"Public suffix (eTLD)","description":"","parameters":[{"name":"domain","in":"query","required":true,"description":"Hostname or URL","schema":{"type":"string"},"example":"example.com.au"},{"name":"private","in":"query","required":false,"description":"Treat private suffixes (github.io, etc.) as public (true/false)","schema":{"type":"string"},"example":"false"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"input":"example.com.au","hostname":"example.com.au","is_icann":true,"is_private":false,"public_suffix":"com.au"},"meta":{"timestamp":"2026-05-30T18:16:48.782Z","request_id":"2b7fc734-d8b4-4913-81da-4d915dda770e"},"status":"ok","message":"Suffix retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":5,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":300,"monthly_call_quota":150000,"rps_limit":20,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":900,"monthly_call_quota":1000000,"rps_limit":50,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2500,"monthly_call_quota":6000000,"rps_limit":150,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/domain-api"}