POST AI agent ready /v1/url/parse

URL Parse API - 免费 URL 组件提取器

将 URL 分解为其结构组件：协议、主机名、端口、路径名、搜索参数（作为键值对）和哈希片段。对于 URL 分析和路由逻辑很有用。

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/url/parse \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/path?q=test&page=2#section"}'

When to use this API

无服务器函数中基于 URL 的路由

解析传入的请求 URL 以提取路径段和查询参数以进行请求路由，而无需完整的框架。

链接分析和分类

从用户提交的 URL 中提取主机名，以按域对链接进行分类、检测附属 URL 或阻止特定来源。

分析标签提取

解析营销 URL 以提取 UTM 参数（utm_source、utm_medium、utm_campaign）以跟踪归因。

Frequently asked questions

查询参数是否作为对象返回？

是的。 searchParams 字段包含一个键值对象，其中每个查询参数都是一个单独的条目。

重复的查询参数键会发生什么情况？

重复的键以数组形式返回。例如， ?tag=a&tag=b 生成 { tag: ["a", "b"] }。

它可以处理相对 URL 吗？

API 需要带有协议的绝对 URL。诸如“/page?q=1”之类的相对路径会返回错误。

是否支持国际化域名？

是的。 API 处理 IDN (punycode) 域并在响应中对它们进行解码。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.