URL parser and risk hints API

Normalize a URL and flag suspicious structure such as credentials, uncommon ports, IP hosts, and Unicode hostnames.

Price$0.01per request

MethodPOST

Route/v1/security/url/parse

StatusLive

MIME typeapplication/json

Rate limit180/minute

CacheNo cache

securityurlphishingparser

API URLhttps://x402.hexl.dev/v1/security/url/parse

Integration docs

Example request

{
  "url": "https://example.com/login"
}

Example response

{
  "normalizedUrl": "https://example.com/login",
  "scheme": "https",
  "hostname": "example.com",
  "punycodeHostname": "example.com",
  "port": null,
  "path": "/login",
  "suspicious": false,
  "warnings": [],
  "provider": "node-url"
}

Input schema

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "normalizedUrl",
    "scheme",
    "hostname",
    "suspicious",
    "warnings",
    "provider"
  ],
  "properties": {
    "normalizedUrl": {
      "type": "string"
    },
    "scheme": {
      "type": "string"
    },
    "hostname": {
      "type": "string"
    },
    "punycodeHostname": {
      "type": "string"
    },
    "port": {
      "type": [
        "string",
        "null"
      ]
    },
    "path": {
      "type": "string"
    },
    "suspicious": {
      "type": "boolean"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "provider": {
      "type": "string"
    }
  }
}