web-url-parse Edge Function — Web Search

web-url-parse — Parse a URL into structured parts

Decompose any URL into protocol, host, pathname, query params, hash, and more. Supports repeated query keys as arrays.

---

API

POST /api/web-url-parse

Request body

Field	Type	Required	Description
url	string	Yes	The URL string to parse

Success response (200)

{
  "success": true,
  "data": {
    "protocol": "https",
    "host": "example.com",
    "hostname": "example.com",
    "port": null,
    "pathname": "/path",
    "search": "?foo=bar",
    "hash": "#section",
    "origin": "https://example.com",
    "query": { "foo": "bar" },
    "valid": true
  }
}

Error responses

Code	HTTP	When
INVALID_INPUT	400	Missing url field
INTERNAL_ERROR	500	Unexpected error

---

Usage

cURL

curl -X POST "$FUNCTION_URL" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/path?tag=a&tag=b#section"}'

TypeScript / JavaScript

const response = await fetch(FUNCTION_URL, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ url: 'https://example.com/path?foo=bar' }),
});
const { data } = await response.json();
console.log(data.query); // { foo: 'bar' }

Direct import

import { webUrlParse } from '@aerostack/functions/web-url-parse';

const result = webUrlParse({ url: 'https://example.com?tag=a&tag=b' });
console.log(result.query); // { tag: ['a', 'b'] }

---

Use Cases

• Extracting UTM parameters from marketing URLs for analytics
• Validating and normalizing incoming redirect URLs
• Building URL-aware routing logic in edge middleware