Normalize URL

Overview

You send a URL and we rewrite it the same way every time: resolve it against a base URL when it is relative, lowercase the scheme and host, drop the default port, collapse ".." and "." path segments, sort the query, and strip common tracking parameters such as utm_source, fbclid, gclid, and ref. You get the rewritten URL plus its parts and the list of parameters we dropped. There is no universal canonical form, so compare with the result rather than assuming a server will treat it identically.

Comparing URLs by hand goes wrong quietly, so you get one documented rewrite instead of ad-hoc string surgery scattered across your code.

When to use it

Scope

Non-goals

• Does not fetch the URL or check that it exists
• Does not shorten or expand a URL
• Does not decode or re-encode percent-escapes in the path or query
• Does not promise the rewritten URL behaves identically at the server

Properties

Capabilities

Cost & billing

Flat rate per invocation

File handling

How we handle your data

Input schema

Output schema

API contract

curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"web.normalize_url","input":{"url":"https://EXAMPLE.com/a/../b"}}'

import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("web.normalize_url", {"url":"https://Example.com:443/blog/../pricing?utm_source=newsletter&plan=team#faq"});

Errors

Other limits

Limitations

• Does not fetch the URL or check that it exists
• Does not shorten or expand a URL
• Does not decode or re-encode percent-escapes in the path or query
• Does not promise the rewritten URL behaves identically at the server
• Checking whether a URL is reachable — reach for web.check_url_status
• Building a request URL where dropping a parameter would change the response

How to call

POST /v1/execute (requires authentication)

{
  "skillKey": "web.normalize_url",
  "input": {
    "url": "https://Example.com:443/blog/../pricing?utm_source=newsletter&plan=team#faq"
  }
}

Examples

{
  "url": "https://Example.com:443/blog/../pricing?utm_source=newsletter&plan=team#faq"
}

{
  "ok": true,
  "removedQueryParams": [
    "utm_source"
  ],
  "components": {
    "scheme": "https",
    "host": "example.com",
    "port": null,
    "path": "/pricing",
    "query": "plan=team",
    "fragment": "faq"
  },
  "normalizedUrl": "https://example.com/pricing?plan=team#faq"
}

{
  "policy": "privacy",
  "url": "https://example.com/pricing?utm_source=newsletter#faq"
}

{
  "ok": true,
  "removedQueryParams": [
    "utm_source"
  ],
  "components": {
    "scheme": "https",
    "host": "example.com",
    "port": null,
    "path": "/pricing",
    "query": "",
    "fragment": ""
  },
  "normalizedUrl": "https://example.com/pricing"
}

Recommended use cases

• Deduplicate URLs before you store them or count them in analytics
• Strip tracking parameters so two shared links compare equal
• Turn the relative links on a page into absolute ones against a base URL

Avoid for

• Checking whether a URL is reachable — reach for web.check_url_status
• Building a request URL where dropping a parameter would change the response

Related skills

Composable with

Safety & privacy

• Runs without calling any external service.
• Your payloads are never stored permanently.
• Telemetry captures metadata only — never your payload contents.
• We never train models on your payloads.
• No human reviews your payloads.

Tags