跳转到内容
POST AI agent ready /v1/useragent/parse

用户代理解析器 API - 检测浏览器、操作系统和设备

将用户代理字符串解析为浏览器、引擎、操作系统和设备组件。 检测机器人、爬虫和无头浏览器。 如果未提供 user_agent 字段,则使用调用者的 User-Agent 标头。

Parameters

stringrequired

User agent string to parse.

Code examples

curl -X POST https://api.botoi.com/v1/useragent/parse \
  -H "Content-Type: application/json" \
  -d '{"user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"}'

When to use this API

构建浏览器兼容性仪表板

从分析日志中解析用户代理字符串,以计算每个浏览器和版本上的访问者百分比。 确定旧浏览器版本何时低于支持阈值,以便您可以取消 Polyfill 并减小捆绑包大小。

从转化指标中过滤机器人流量

在计算页面浏览量或注册事件之前,请解析用户代理并检查 is_bot 标志。 从转化渠道报告中排除机器人流量,以获得真实人类访问者的准确数字。

提供设备优化响应

在边缘解析用户代理以确定访问者是使用移动设备、平板电脑还是桌面设备。 为移动用户返回更轻的负载,或将平板电脑访问者重定向到触摸优化的布局。

Frequently asked questions

该端点检测哪些机器人类型?
它检测搜索引擎爬虫(Googlebot、Bingbot)、社交媒体机器人(Twitterbot、Facebot)、监控工具、无头浏览器(Puppeteer、Playwright)和常见的抓取库。
如果用户代理字符串格式错误会发生什么情况?
解析器提取尽可能多的信息。 它无法确定的字段将返回为 null。 对于无法识别的字符串,端点不会返回错误。
我可以检测设备制造商吗?
是的。 当用户代理包含该信息时,设备对象包括供应商(例如 Apple、Samsung、Google)和型号(例如 iPhone、Galaxy S24)。
这适用于非浏览器用户代理吗?
是的。 它处理来自curl、Postman、Python 请求和其他HTTP 库的用户代理。 这些是用它们的工具名称和版本来解析的。
如果我不发送 user_agent 字段怎么办?
端点自动解析 HTTP 请求中的 User-Agent 标头。 这使您可以检测自己客户端的浏览器和设备,而无需自己提取标头。

Get your API key

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