{"uid":"cap_ChOP69Koo653EfwF4tmiw","slug":"tanod-web-url-parser-b20a20c4","name":"Tanod Web URL Parser","description":"Web tools: search, page to Markdown or screenshot, company profile and jobs, sitemaps, RDAP, IP.","url":"https://web.tanod.dev/v1/url?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"minLength":1,"description":"URL to parse (never fetched); printable, no whitespace (percent-encode it). Without :// it is read as https://."}}},"responseSchema":{"type":"json","example":{"host":"shop.example.co.uk","path":"/a","port":null,"is_ip":false,"query":"b=1","params":[["b","1"]],"scheme":"https","source":{"url":"https://publicsuffix.org/","library":"tldextract 5.4.0 (bundled Public Suffix List snapshot) + idna 3.20","license":"BSD-3-Clause (libraries); PSL data MPL-2.0"},"fragment":null,"username":null,"subdomain":"shop","host_ascii":"shop.example.co.uk","idna_valid":true,"ip_version":null,"normalized":"https://shop.example.co.uk/a?b=1","domain_label":"example","has_password":false,"host_scripts":["LATIN"],"host_unicode":"shop.example.co.uk","icann_suffix":"co.uk","known_suffix":true,"path_segments":["a"],"public_suffix":"co.uk","effective_port":443,"scheme_assumed":false,"params_truncated":false,"suffix_is_private":false,"mixed_script_label":false,"registrable_domain":"example.co.uk","path_segments_truncated":false,"icann_registrable_domain":"example.co.uk"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UVuDVMGv1igM81VPd5wht","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses and normalizes a URL into its structural components (scheme, host, subdomain, domain, suffix, path, query params, port, IDNA validity, etc.) without fetching it.","exampleAgentPrompt":"Parse the URL https://shop.example.co.uk/a?b=1 and tell me its subdomain, registrable domain, public suffix, path segments, and query parameters.","exampleUseCases":[{"title":"Domain extraction for content pipeline","prompt":"I have a list of URLs from user submissions — can you parse https://blog.openai.com/gpt-4-research?ref=newsletter and tell me the registrable domain, subdomain, and public suffix so I can group them by origin?"},{"title":"Internationalized URL validation","prompt":"Can you check whether xn--bcher-kva.example.de is a valid IDNA hostname and tell me what Unicode form it decodes to, along with the domain's public suffix?"},{"title":"Query parameter extraction for analytics","prompt":"Pull apart the URL https://store.myshop.com/products/shoes?color=red&size=10&discount=true and give me each query parameter as a structured key-value list along with the path segments."}],"resultDescription":"A JSON object containing the fully decomposed URL: normalized form, scheme (with flag if assumed), host (ASCII and Unicode), subdomain, domain label, public suffix, registrable domain, ICANN registrable domain, path, path segments, query string, parsed query params, port (explicit and effective), fragment, username, IP version and is_ip flag, IDNA validity, host Unicode scripts, mixed-script flag, and truncation indicators for params and path segments.","failureModes":["Empty or missing 'url' field returns a validation error","URL exceeding 2048 characters is rejected","Whitespace in URL causes rejection — must be percent-encoded","Non-printable characters in URL cause parse failure","Malformed percent-encoding may cause an error or unexpected normalization","Payment failure (402) if USDC micropayment is not attached"],"whenToPreferThis":"Choose this endpoint when you need fast, offline-style URL decomposition with accurate public suffix resolution (using the Mozilla Public Suffix List) and IDNA/Unicode hostname handling — without making an HTTP request to the target URL. Ideal for pipelines that normalize, deduplicate, or group URLs by domain, or that need to extract query parameters and path segments programmatically. Prefer over regex-based parsing when correctness for ccTLDs (e.g. .co.uk, .com.au) and internationalized hostnames matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:44:43.473Z","isFirstParty":false,"canonicalSlug":"tanod-web-url-parser-b20a20c4"}