# SignalHarness URL Normalize & Canonicalize

> SignalHarness URL Normalize & Canonicalize is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Normalizes and canonicalizes a URL, decomposing it into origin, path, query, and fragment components while optionally stripping tracking parameters.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/url_normalize_canonicalize/invoke
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signalharness-url-normalize-canonicalize-1887a154
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8WWcqw8E2_f_xVVfgCM2w

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability signalharness-url-normalize-canonicalize-1887a154 -d '<json body>'
```

Example prompt: Can you normalize and canonicalize this URL for me — https://example.com/page?utm_source=twitter&utm_medium=social#section — and strip out any tracking parameters?

## When to prefer this

Use this endpoint when you need deterministic, auditable URL normalization with a clear record of what transformations were applied. Ideal for deduplication pipelines, link-cleaning workflows, and agent systems that need to compare or store canonical URLs consistently. Priced per-call at $0.005 USDC via x402, making it suitable for high-frequency automated workflows without a subscription.

## Known failure modes

- Malformed or unparseable URL returns an error status
- URL exceeds 2048 character limit causes validation rejection
- Missing required 'url' field results in a bad request error
- Network or service downtime returns a failed status in the receipt

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns the normalized/canonical URL along with its decomposed components (origin, path, query string, fragment), the original URL, a list of transformations applied during normalization, and payment receipt metadata including latency, execution ID, and a SHA-256 hash of the result.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 1
  },
  "baseUrl": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 1
  },
  "removeTrackingParameters": {
   "type": "boolean"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "path": "example",
   "query": "example",
   "origin": "example",
   "fragment": "example",
   "original": "example",
   "normalized": "example",
   "transformations": [
    "example"
   ]
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "url_normalize_canonicalize",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "5000",
   "resultSha256": "34e2fa8b83011c967ff9d7be25edf69b81f4df8cff4ab28f8020a0f113e02362",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signalharness-url-normalize-canonicalize-1887a154/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)