{"uid":"cap_i-uAOXM4A-dKr3b8LdXDb","slug":"one-engine-url-normalize-180279ea","name":"ONE Engine URL Normalize","description":"Parse and normalize an HTTP/HTTPS URL into agent-ready structured components","url":"https://one-search.one-engine.workers.dev/v1/url/normalize?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","description":"HTTP or HTTPS URL"},"sort_query":{"type":"boolean","description":"Sort query parameters. Defaults to false."},"strip_fragment":{"type":"boolean","description":"Remove URL fragment. Defaults to false."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0012","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.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_b-zfCkhb3BO0JJBYCiCiQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses and normalizes an HTTP/HTTPS URL into structured components like scheme, host, path, query, and fragment","exampleAgentPrompt":"Can you parse this URL into its structured components — scheme, host, path, and query params — and sort the query parameters while stripping the fragment? The URL is https://example.com/search?z=3&a=1#section2","exampleUseCases":[{"title":"Deduplicating crawled URLs","prompt":"I have this URL from my web crawler: https://shop.example.com/products?color=blue&size=M&ref=homepage#reviews — can you normalize it with the fragment stripped and query params sorted so I can compare it consistently against others?"},{"title":"Extracting hostname for analytics","prompt":"Break down this URL for me so I can get just the host and path separately: https://api.partner.io/v2/orders?status=pending&page=2"},{"title":"Sanitizing URLs before storage","prompt":"Before I store this URL in my database, normalize it and sort the query parameters so the format is consistent: https://cdn.mysite.net/images/hero.jpg?v=3&format=webp&quality=80"}],"resultDescription":"A structured JSON object containing the parsed URL components including scheme, host, path, query parameters (optionally sorted), and fragment (optionally stripped), plus the fully normalized URL string ready for agent use.","failureModes":["Invalid or malformed URL returns an error — non-HTTP/HTTPS protocols (e.g. ftp://, mailto:) are likely rejected","Empty or missing url field returns a validation error","Relative URLs without a scheme may fail to parse","Network timeout on the workers.dev edge function"],"whenToPreferThis":"Use this endpoint when you need to reliably decompose, clean, or canonicalize a URL for comparison, storage, or downstream processing — especially in agent pipelines that deal with web crawling, link deduplication, or URL normalization at low cost ($0.0012/call via x402). Prefer this over custom regex parsing when you need structured output with optional query sorting and fragment stripping.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T02:57:03.234Z","isFirstParty":false,"canonicalSlug":"one-engine-url-normalize-180279ea"}