Agent URL & SSRF Firewall API
Validate URLs and redirect chains against SSRF, private IPs, and cloud metadata targets.
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.
{
"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
}
}
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"
}
}
}POST /v1/url-normalizer)| Parameter | Type & Constraints | Description |
|---|---|---|
url required |
stringminLen: 1, maxLen: 8192 |
URL to canonicalize and strip tracking parameters from. |
strip_tracking optional |
booleandefault: 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 |
booleandefault: true |
Sort remaining query parameters alphabetically by key. |
strip_fragment optional |
booleandefault: true |
Remove URL hash fragment (#...). |
strip_www optional |
booleandefault: false |
Remove leading 'www.' subdomain. |
strip_trailing_slash optional |
booleandefault: true |
Remove trailing slash from non-root paths (/blog/post/ -> /blog/post). |
force_https optional |
booleandefault: false |
Upgrade http:// scheme to https://. |
resolve_shorteners optional |
booleandefault: 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). |
data Object Fields (200 OK)| Field | Type | Description |
|---|---|---|
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' |
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 →
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).
| Plan | Monthly Price | Included Requests | Rate Limit | Max Payload | Best For |
|---|---|---|---|---|---|
| BASIC | $0.00 / mo | 500 / month | 10 req / min | 64 KB | Evaluation & CI smoke tests |
| PRO | $9.99 / mo | 15,000 / month | 60 req / min | 128 KB | Solo devs & production apps |
| ULTRA | $29.99 / mo | 100,000 / month | 300 req / min | 256 KB | Growing SaaS & multi-agent pipelines |
| MEGA | $79.99 / mo | 500,000 / month | 1,000 req / min | 256 KB | High-volume enterprise workloads |
Without stripping utm_*, fbclid, and gclid parameters, the same article URL gets indexed dozens of times under different cache keys.
Yes, only known analytics, ad-click, and email-tracking parameters are removed; functional parameters are preserved and sorted.
Yes, redirect unrolling uses the edgeguard-fetcher Worker with full RFC1918/metadata IP blocking.
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.
Validate URLs and redirect chains against SSRF, private IPs, and cloud metadata targets.
Convert noisy web pages or raw HTML into clean, token-efficient Markdown for RAG.
Audit which AI crawlers your robots.txt allows and generate a valid llms.txt file.