{"uid":"cap_IvpglGvUCEXzsJhV9zj3I","slug":"tld-public-suffix-info-lookup-ea466040","name":"TLD & Public Suffix Info Lookup","description":"TLD registry intelligence and public-suffix analysis. Mode 1 (tld=io): IANA root-zone metadata — type (generic / country-code / sponsored), managing organization, unicode form for IDN TLDs. Mode 2 (domain=shop.example.co.uk): full Public Suffix List algorithm — the effective public suffix (co.uk), the registrable domain (example.co.uk), the subdomain part, the matched PSL rule, and whether the suffix is ICANN (registry) or private (corporate, e.g. github.io / s3.amazonaws.com) — plus the root-zone metadata for its TLD. Correctly handles wildcard and exception rules and IDN/punycode input. Use for cookie scoping, per-registrant rate limiting, URL dedup, and abuse/phishing analysis. Data: IANA root zone + Mozilla PSL, refreshed weekly.","url":"https://2s.io/api/tld/info","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"tld":{"type":"string","description":"TLD label, with or without the dot (XOR with domain)."},"domain":{"type":"string","description":"Full domain to analyze against the PSL (XOR with tld)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"tld":"com"}}},"response":{"data":{"ok":true,"meta":{"sources":[{"url":"https://www.iana.org/domains/root/db","provider":"IANA Root Zone Database (iana.org)"},{"url":"https://publicsuffix.org/","provider":"Mozilla Public Suffix List (publicsuffix.org), MPL 2.0"}]},"items":[{"tld":{"tld":"com","type":"generic","manager":"VeriSign Global Registry Services","unicodeTld":"com"},"query":"com","suffix":null}],"total":1,"source":{"url":"https://www.iana.org/domains/root/db","license":"Public domain (US-administered registry data); PSL component is MPL 2.0 (see meta.sources).","provider":"IANA Root Zone Database (iana.org)"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"tld.info","settlement":{"txHash":"0xc675f2d212a06b99b51c8b28f0771aac70e9b538b30af308b5803144a64fc7bd","network":"eip155:8453","success":true}}}},"exampleRequest":{"tld":"com"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ULOqIrP_9sejuU70HPkWY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured TLD metadata and Public Suffix List analysis for a given TLD label or full domain, including registrable domain, suffix section, and IANA registry details.","exampleAgentPrompt":"What type of TLD is .co.uk, who manages it, and what would be the registrable domain for shop.example.co.uk?","exampleUseCases":null,"resultDescription":"A JSON object with ok:true, the TLD's type (e.g. country-code or generic), its IANA manager, the matched PSL rule, the public suffix, the registrable domain, any subdomain, and source attribution from IANA and Mozilla PSL.","failureModes":["Missing both tld and domain query params — validation error","Invalid or unrecognized TLD not in IANA root zone — may return empty items or no match","Supplying both tld and domain simultaneously (XOR constraint violated) — input error","Network or upstream IANA/PSL data unavailability — service error","Payment failure via x402 — 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need authoritative TLD classification (country-code vs generic), IANA manager information, or need to decompose a full domain into its public suffix, registrable domain, and subdomain according to the Mozilla PSL — especially for domain validation, security checks, or cookie-scoping logic.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:58:44.756Z","isFirstParty":false}