Punycode / IDNA domain API

Encodes/decodes IDNA domain names label-by-label using RFC3492 Punycode (the xn-- ACE form), returning per-label mapping. Answers 'What is the xn-- form of münchen.de?', 'Decode this internationalized domain name.'

Price$0.02per request

MethodPOST

Route/v1/encoding/punycode

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

punycodeidnadomainxn--rfc3492encodedecodeencoding

API URLhttps://x402.hexl.dev/v1/encoding/punycode

Integration docs

Example request

{
  "value": "münchen.de"
}

Example response

{
  "operation": "encode",
  "result": "xn--mnchen-3ya.de",
  "labels": [
    {
      "input": "münchen",
      "output": "xn--mnchen-3ya"
    },
    {
      "input": "de",
      "output": "de"
    }
  ],
  "interpretation": "IDNA encode: 'münchen.de' -> 'xn--mnchen-3ya.de'."
}

Input schema

{
  "type": "object",
  "required": [
    "value"
  ],
  "properties": {
    "value": {
      "type": "string",
      "examples": [
        "münchen.de"
      ]
    },
    "operation": {
      "type": "string",
      "enum": [
        "encode",
        "decode"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}