Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Developer Utilities Tier 2 All-Access

URL Canonicalizer & UTM / Click-ID Tracking Stripper API

Canonicalize URLs and strip 120+ ad-tracking and click-ID parameters for clean deduplication. Canonicalize URLs for deduplication and RAG indexing: strip 120+ tracking parameters (utm_*, fbclid, gclid, msclkid, mc_eid), sort query keys, and unshorten links.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/url-normalizerinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": true,
    "original_url": "HTTPS://WWW.Example.com:443/blog/post/?utm_source=newsletter&fbclid=IwAR123&id=42#section-1",
    "normalized_url": "https://www.example.com/blog/post?id=42",
    "components": {
      "scheme": "https",
      "hostname": "www.example.com",
      "port": null,
      "pathname": "/blog/post",
      "query": {
        "id": "42"
      },
      "fragment": null
    },
    "is_shortener": false,
    "unrolled": false,
    "redirect_hops": 0,
    "stripped_params": [
      "utm_source",
      "fbclid"
    ],
    "ssrf_safe": true,
    "error": null
  },
  "meta": {
    "request_id": "req_url_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/url-normalizer" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"url":"HTTPS://WWW.Example.com:443/blog/post/?utm_source=newsletter&fbclid=IwAR123&id=42#section-1"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/url-normalizer", {
  "url": "HTTPS://WWW.Example.com:443/blog/post/?utm_source=newsletter&fbclid=IwAR123&id=42#section-1"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/url-normalizer",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "url": "HTTPS://WWW.Example.com:443/blog/post/?utm_source=newsletter&fbclid=IwAR123&id=42#section-1"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/url-normalizer", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "url": "HTTPS://WWW.Example.com:443/blog/post/?utm_source=newsletter&fbclid=IwAR123&id=42#section-1"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_url_normalizer",
    "arguments": {
      "url": "HTTPS://WWW.Example.com:443/blog/post/?utm_source=newsletter&fbclid=IwAR123&id=42#section-1"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/url-normalizer)

ParameterType & ConstraintsDescription
url required string
minLen: 1, maxLen: 8192
URL to canonicalize and strip tracking parameters from.
strip_tracking optional boolean
default: true
Strip UTM, click-ID (fbclid, gclid, msclkid, etc.), and email tracking parameters.
custom_strip_params optional string[] Additional query parameter names to remove (case-insensitive).
sort_query optional boolean
default: true
Sort remaining query parameters alphabetically by key.
strip_fragment optional boolean
default: true
Remove URL hash fragment (#...).
strip_www optional boolean
default: false
Remove leading 'www.' subdomain.
strip_trailing_slash optional boolean
default: true
Remove trailing slash from non-root paths (/blog/post/ -> /blog/post).
force_https optional boolean
default: false
Upgrade http:// scheme to https://.
resolve_shorteners optional boolean
default: false
If true, resolves redirects via the SSRF-isolated fetcher Worker before normalizing.
strip_userinfo optional boolean Strip user:pass@ credentials from the URL authority (default true).

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
original_url string Field 'original_url'
normalized_url string | null Field 'normalized_url'
components object | null Field 'components'
is_shortener boolean Field 'is_shortener'
unrolled boolean Field 'unrolled'
redirect_hops integer Field 'redirect_hops'
stripped_params string[] Field 'stripped_params'
ssrf_safe boolean Field 'ssrf_safe'
error string | null Field 'error'
warnings string[] Field 'warnings'

What URL Normalizer & Tracking Parameter Stripper API Detects & Validates

  • Strips 120+ known tracking parameters across Google Ads (gclid, gbraid, utm_*), Meta (fbclid), Microsoft (msclkid), TikTok (ttclid), HubSpot (_hsenc), Mailchimp (mc_eid), and Marketo (mkt_tok)
  • RFC 3986 canonicalization: lowercases scheme/host, strips default ports (:80/:443), resolves ../ dot segments, sorts retained query parameters alphabetically
  • Detects IDN homograph punycode domains (xn--)
  • Optional safe short-URL unrolling via SSRF-isolated Fetcher Worker
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Shortener resolution is optional (resolve_shorteners: true) and capped at 5 redirect hops via the SSRF-guarded fetcher.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Why normalize URLs before storing bookmarks or RAG document chunks?

Without stripping utm_*, fbclid, and gclid parameters, the same article URL gets indexed dozens of times under different cache keys.

Does it preserve functional query parameters like ?id=42 or ?page=2?

Yes, only known analytics, ad-click, and email-tracking parameters are removed; functional parameters are preserved and sorted.

Is redirect unshortening protected against SSRF?

Yes, redirect unrolling uses the edgeguard-fetcher Worker with full RFC1918/metadata IP blocking.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Stateless in-memory URL normalization; zero logging.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/ssrf-firewall Security & Secrets

Agent URL & SSRF Firewall API

Validate URLs and redirect chains against SSRF, private IPs, and cloud metadata targets.

POST /v1/html-to-markdown Tier 1

LLM HTML-to-Markdown Cleaner API

Convert noisy web pages or raw HTML into clean, token-efficient Markdown for RAG.

POST /v1/robots-llms-analyzer Developer Utilities

robots.txt & llms.txt AI Crawler Analyzer & Generator API

Audit which AI crawlers your robots.txt allows and generate a valid llms.txt file.