UA 解析与爬虫识别

正常 NEW

User-Agent 结构化解析与爬虫识别，支持基础解析与风险检测两种模式。

协议：HTTP 格式：JSON 版本：v1.0.0日调用量：1560次

¥ 0.001 / 次

按次计费

购买次数包更优惠，低至 0.0008 元/次

100次调用包 100 次调用 ¥0.0010 /次

500次调用包 500 次调用 ¥0.00095 /次省 5%

1000次调用包 1,000 次调用 ¥0.0009 /次省 10%

推荐 5000次调用包 5,000 次调用 ¥0.00085 /次省 15%

热门 10000次调用包 10,000 次调用 ¥0.0008 /次省 20%

健康检查

服务存活探测

服务存活探测接口，返回服务版本与服务器当前时间。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ua/ping JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息（健康检查固定为 pong）
data	object	业务数据
data.version	string	数据版本
data.time	string	数据时间

请求示例

返回示例

{"msg":"pong","code":200,"data":{"time":"2026-10-22 22:39:06","version":"1.0"}}

爬虫分类列表

返回爬虫分类列表

返回爬虫分类字典（10 个分类），含中英文名称、是否友好、分类说明。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ua/categories JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.count	integer	数量
data.categories	object	分类数据
data.categories.search-spider	object	爬虫分类「search-spider」的信息
data.categories.search-spider.name_zh	string	中文名称
data.categories.search-spider.name_en	string	英文名称
data.categories.search-spider.benign	boolean	是否安全
data.categories.search-spider.desc	string	描述
data.categories.seo-crawler	object	爬虫分类「seo-crawler」的信息
data.categories.seo-crawler.name_zh	string	中文名称
data.categories.seo-crawler.name_en	string	英文名称
data.categories.seo-crawler.benign	boolean	是否安全
data.categories.seo-crawler.desc	string	描述
data.categories.scraper	object	爬虫分类「scraper」的信息
data.categories.scraper.name_zh	string	中文名称
data.categories.scraper.name_en	string	英文名称
data.categories.scraper.benign	boolean	是否安全
data.categories.scraper.desc	string	描述
data.categories.scanner	object	爬虫分类「scanner」的信息
data.categories.scanner.name_zh	string	中文名称
data.categories.scanner.name_en	string	英文名称
data.categories.scanner.benign	boolean	是否安全
data.categories.scanner.desc	string	描述
data.categories.monitor	object	爬虫分类「monitor」的信息
data.categories.monitor.name_zh	string	中文名称
data.categories.monitor.name_en	string	英文名称
data.categories.monitor.benign	boolean	是否安全
data.categories.monitor.desc	string	描述
data.categories.security	object	爬虫分类「security」的信息
data.categories.security.name_zh	string	中文名称
data.categories.security.name_en	string	英文名称
data.categories.security.benign	boolean	是否安全
data.categories.security.desc	string	描述
data.categories.tool	object	爬虫分类「tool」的信息
data.categories.tool.name_zh	string	中文名称
data.categories.tool.name_en	string	英文名称
data.categories.tool.benign	boolean	是否安全
data.categories.tool.desc	string	描述
data.categories.downloader	object	爬虫分类「downloader」的信息
data.categories.downloader.name_zh	string	中文名称
data.categories.downloader.name_en	string	英文名称
data.categories.downloader.benign	boolean	是否安全
data.categories.downloader.desc	string	描述
data.categories.feed	object	爬虫分类「feed」的信息
data.categories.feed.name_zh	string	中文名称
data.categories.feed.name_en	string	英文名称
data.categories.feed.benign	boolean	是否安全
data.categories.feed.desc	string	描述
data.categories.library	object	爬虫分类「library」的信息
data.categories.library.name_zh	string	中文名称
data.categories.library.name_en	string	英文名称
data.categories.library.benign	boolean	是否安全
data.categories.library.desc	string	描述

请求示例

返回示例

{"msg":"success","code":200,"data":{"count":10,"categories":{"feed":{"desc":"RSS/Atom Feed 订阅抓取器","benign":true,"name_en":"Feed Reader","name_zh":"RSS 订阅器"},"tool":{"desc":"curl/wget/aria2 等通用命令行工具","benign":true,"name_en":"CLI Tool","name_zh":"命令行工具"},"library":{"desc":"Python-Requests/Go-http-client 等编程库","benign":true,"name_en":"HTTP Library","name_zh":"HTTP 库"},"monitor":{"desc":"站点监控、可用性检测服务","benign":true,"name_en":"Monitor","name_zh":"监控机器人"},"scanner":{"desc":"安全扫描器、漏洞探测工具","benign":false,"name_en":"Scanner","name_zh":"漏洞扫描器"},"scraper":{"desc":"通用网页内容采集/数据抓取工具","benign":false,"name_en":"Scraper","name_zh":"网页采集器"},"security":{"desc":"安全研究、学术机构爬虫","benign":true,"name_en":"Security","name_zh":"安全研究"},"downloader":{"desc":"下载工具、断点续传客户端","benign":true,"name_en":"Downloader","name_zh":"下载器"},"seo-crawler":{"desc":"Ahrefs/Semrush/MJ12 等 SEO 数据采集爬虫","benign":false,"name_en":"SEO Crawler","name_zh":"SEO 采集器"},"search-spider":{"desc":"Google/Bing/Baidu 等搜索引擎官方蜘蛛","benign":true,"name_en":"Search Spider","name_zh":"搜索引擎蜘蛛"}}}}

已知爬虫列表

返回爬虫分类概要列表（不含识别规则）

返回爬虫分类概要列表，包含 id、名称、厂商、分类、是否官方、是否具有攻击性。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ua/bots JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.count	integer	数量
data.bots	array	爬虫列表
data.bots[]	object	爬虫
data.bots[].id	string	唯一标识
data.bots[].name	string	名称
data.bots[].vendor	string	厂商
data.bots[].category	string	分类
data.bots[].official	boolean	是否官方爬虫
data.bots[].aggressive	boolean	是否具有攻击性

请求示例

返回示例

{"msg":"success","code":200,"data":{"bots":[{"id":"googlebot","name":"Googlebot","vendor":"Google","category":"search-spider","official":true,"aggressive":false},{"id":"bingbot","name":"Bingbot","vendor":"Microsoft","category":"search-spider","official":true,"aggressive":false},{"id":"baiduspider","name":"Baiduspider","vendor":"Baidu","category":"search-spider","official":true,"aggressive":false}],"count":576}}

UA 解析

解析单个 UA 字符串

解析单个 User-Agent 字符串，输出浏览器/系统/设备、爬虫识别、异常与无头检测结果；不含 PTR 反查与 IP 风险联动。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ua/parse JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ua	string	是	User-Agent 字符串（上限 1024 字符）
headers	string	否	可选，JSON 字符串形式的请求头，用于无头浏览器检测；也支持 h[Header-Name]=value 形式

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ua	string	User-Agent 字符串
data.parsed	object	UA 解析结果
data.parsed.browser	object	浏览器信息
data.parsed.browser.name	string	名称
data.parsed.browser.version	string	版本
data.parsed.browser.engine	string	浏览器引擎
data.parsed.os	object	操作系统
data.parsed.os.name	string	名称
data.parsed.os.version	string	版本
data.parsed.device	object	设备信息
data.parsed.device.type	string	类型
data.parsed.device.brand	string\|null	品牌（未识别时为 null）
data.parsed.device.model	string\|null	设备型号（未识别时为 null）
data.parsed.isMobile	boolean	是否移动设备
data.parsed.isDetected	boolean	是否检测到
data.bot	object	爬虫识别信息
data.bot.isBot	boolean	是否为爬虫
data.bot.id	string	唯一标识
data.bot.name	string	名称
data.bot.vendor	string	厂商
data.bot.category	string	分类
data.bot.categoryName	string	分类名称
data.bot.official	boolean	是否官方爬虫
data.bot.aggressive	boolean	是否具有攻击性
data.bot.confidence	integer	置信度
data.anomaly	object	异常检测信息
data.anomaly.isAnomalous	boolean	是否为异常流量
data.anomaly.score	integer	评分
data.anomaly.signals	array	风险信号列表
data.verdict	string	判定结果
data.cached	boolean	是否命中缓存
data.headless	object	无头浏览器检测信息
data.headless.isHeadless	boolean	是否为无头浏览器
data.headless.confidence	integer	置信度
data.headless.signals	array	风险信号列表
data.headless.engine	string\|null	无头浏览器引擎（未识别时为 null）
data.risk	object\|null	IP 风险信息（parse 模式恒为 null）
data.ptrVerified	boolean\|null	PTR 是否验证通过（未触发校验时为 null）
data.asnVerified	boolean\|null	ASN 是否验证通过（未触发校验时为 null）
data.headless.signals[]	string	无头浏览器风险信号

请求示例

返回示例

{"msg":"success","code":200,"data":{"ua":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36","bot":{"id":null,"name":null,"isBot":false,"vendor":null,"category":null,"official":false,"aggressive":false,"confidence":0,"categoryName":null},"risk":null,"cached":true,"parsed":{"os":{"name":"Windows","version":"10"},"device":{"type":"desktop","brand":null,"model":null},"browser":{"name":"Chrome","engine":"Blink","version":"120"},"isMobile":false,"isDetected":true},"anomaly":{"score":0,"signals":[],"isAnomalous":false},"verdict":"human","headless":{"engine":null,"signals":[],"confidence":0,"isHeadless":false},"asnVerified":null,"ptrVerified":null}}

爬虫检测

检测 UA 是否为爬虫

在 parse 基础上叠加 PTR 反查、ASN 校验与 IP 风险联动，输出 risk/ptrVerified/asnVerified，并可将官爬伪装判定为 spoofed。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

GET http://www.shujuyu.cn/v1/api/ua/detect JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
ua	string	是	User-Agent 字符串（上限 1024 字符）
ip	string	是	待检测 IP，必填；缺失 → 400（缺少参数），非合法 IP → 400（无效的 IP 地址）
headers	string	否	可选，JSON 字符串形式的请求头，用于无头浏览器检测；也支持 h[Header-Name]=value 形式
risk	string	否	可选，传 0/false/no/off 时置空 risk 字段

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.ua	string	User-Agent 字符串
data.parsed	object	UA 解析结果
data.parsed.browser	object	浏览器信息
data.parsed.browser.name	string	名称
data.parsed.browser.version	string	版本
data.parsed.browser.engine	string	浏览器引擎
data.parsed.os	object	操作系统
data.parsed.os.name	string	名称
data.parsed.os.version	string	版本
data.parsed.device	object	设备信息
data.parsed.device.type	string	类型
data.parsed.device.brand	string\|null	品牌（未识别时为 null）
data.parsed.device.model	string\|null	设备型号（未识别时为 null）
data.parsed.isMobile	boolean	是否移动设备
data.parsed.isDetected	boolean	是否检测到
data.bot	object	爬虫识别信息
data.bot.isBot	boolean	是否为爬虫
data.bot.id	string	唯一标识
data.bot.name	string	名称
data.bot.vendor	string	厂商
data.bot.category	string	分类
data.bot.categoryName	string	分类名称
data.bot.official	boolean	是否官方爬虫
data.bot.aggressive	boolean	是否具有攻击性
data.bot.confidence	integer	置信度
data.anomaly	object	异常检测信息
data.anomaly.isAnomalous	boolean	是否为异常流量
data.anomaly.score	integer	评分
data.anomaly.signals	array	风险信号列表
data.verdict	string	判定结果
data.cached	boolean	是否命中缓存
data.headless	object	无头浏览器检测信息
data.headless.isHeadless	boolean	是否为无头浏览器
data.headless.confidence	integer	置信度
data.headless.signals	array	风险信号列表
data.headless.engine	string\|null	无头浏览器引擎（未识别时为 null）
data.risk	object\|null	IP 风险信息（IP 非法或 risk=0 时为 null）
data.risk.ip	string\|null	IP 地址（未知时为 null）
data.risk.is_risky	boolean	是否存在风险
data.risk.risk_score	integer	风险评分
data.risk.severity	string	风险等级
data.risk.severity_num	integer	风险等级数值
data.risk.grade	object	评级
data.risk.grade.grade	string	评级
data.risk.grade.label	string	标签
data.risk.tags	array	标签列表
data.risk.tags_zh	array	中文标签列表
data.risk.hit_count	integer	命中次数
data.risk.confidence	object	置信度
data.risk.confidence.level	string	等级
data.risk.confidence.score	integer	评分
data.risk.first_seen	string\|null	首次发现时间（无记录时为 null）
data.risk.last_seen	string\|null	最近发现时间（无记录时为 null）
data.risk.matched	array	命中的规则列表
data.ptrDomain	string	PTR 反查到的域名（仅在触发 PTR 反查且查到记录时返回）
data.ptrVerified	boolean\|null	PTR 是否验证通过（未触发校验时为 null）
data.asnVerified	boolean\|null	ASN 是否验证通过（未触发校验时为 null）
data.asn	object	ASN 信息（仅在触发 ASN 校验且查到记录时返回）
data.asn.asn	string	ASN 编号，如 AS15169
data.asn.holder	string	ASN 持有者/运营商名称
data.asn.network	string	ASN 网段，如 8.8.8.0/24
data.headless.signals[]	string	无头浏览器风险信号

请求示例

返回示例

{"msg":"success","code":200,"data":{"ua":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36","bot":{"id":null,"name":null,"isBot":false,"vendor":null,"category":null,"official":false,"aggressive":false,"confidence":0,"categoryName":null},"risk":{"ip":null,"tags":[],"grade":{"grade":"A","label":"可信"},"matched":[],"tags_zh":[],"is_risky":false,"severity":"none","hit_count":0,"last_seen":null,"confidence":{"level":"none","score":0},"first_seen":null,"risk_score":0,"severity_num":0},"cached":true,"parsed":{"os":{"name":"Windows","version":"10"},"device":{"type":"desktop","brand":null,"model":null},"browser":{"name":"Chrome","engine":"Blink","version":"120"},"isMobile":false,"isDetected":true},"anomaly":{"score":0,"signals":[],"isAnomalous":false},"verdict":"human","headless":{"engine":null,"signals":[],"confidence":0,"isHeadless":false},"asnVerified":null,"ptrVerified":null}}

批量解析

批量解析 UA，最多 10 条

批量解析 UA，自动去重并丢弃空字符串，最多处理并返回 10 条，超出直接报错（4002）。

调用方式：在接口地址后拼接 ?key=您的API密钥 即可直接调用；也可改用 Authorization: Bearer 或 X-App-Key 请求头传递，避免密钥出现在访问日志中。

POST http://www.shujuyu.cn/v1/api/ua/batch JSON

请求参数

参数名	类型	必填	说明
key	string	是	您的API密钥，可在个人中心获取
uas	array	是	UA 字符串数组；自动去重、丢弃空串，处理后上限 10 条，超出直接报错
mode	string	否	可选，解析模式 parse/detect，默认 parse
ip	string	否	可选，统一用于本批次所有 UA 的 IP 上下文；不传则为空
headers	object	否	可选，请求头对象（用于无头浏览器检测）；批量接口按 JSON 对象传入，不是 JSON 字符串

返回参数说明

参数名	类型	说明
code	integer	状态码，200 表示成功
msg	string	返回消息
data	object	业务数据
data.total	integer	总条数
data.returned	integer	本次实际返回条数
data.bot_count	integer	爬虫数量
data.human_count	integer	人类访问数量
data.verdict_dist	object	判定结果分布：键为本次批次实际出现的判定结果（human / suspicious / unknown / bot-friendly / bot-malicious），值为对应数量
data.verdict_dist.{verdict}	integer	某个判定结果的数量，键名随本次实际判定结果变化
data.truncated	boolean	保留字段，当前恒为 false（超过 10 条时直接返回 4002 错误，不会截断）
data.max_limit	integer	允许返回的最大条数
data.mode	string	查询匹配模式
data.list	array	数据列表
data.list[]	object	列表中的单条记录
data.list[].ua	string	User-Agent 字符串
data.list[].parsed	object	UA 解析结果
data.list[].parsed.browser	object	浏览器信息
data.list[].parsed.browser.name	string	名称
data.list[].parsed.browser.version	string	版本
data.list[].parsed.browser.engine	string	浏览器引擎
data.list[].parsed.os	object	操作系统
data.list[].parsed.os.name	string	名称
data.list[].parsed.os.version	string	版本
data.list[].parsed.device	object	设备信息
data.list[].parsed.device.type	string	类型
data.list[].parsed.device.brand	string\|null	品牌（示例 UA 为 iPhone；未识别时为 null）
data.list[].parsed.device.model	string\|null	设备型号（示例 UA 为 iPhone；未识别时为 null）
data.list[].parsed.isMobile	boolean	是否移动设备
data.list[].parsed.isDetected	boolean	是否检测到
data.list[].bot	object	爬虫识别信息
data.list[].bot.isBot	boolean	是否为爬虫
data.list[].bot.id	string	唯一标识
data.list[].bot.name	string	名称
data.list[].bot.vendor	string	厂商
data.list[].bot.category	string	分类
data.list[].bot.categoryName	string	分类名称
data.list[].bot.official	boolean	是否官方爬虫
data.list[].bot.aggressive	boolean	是否具有攻击性
data.list[].bot.confidence	integer	置信度
data.list[].anomaly	object	异常检测信息
data.list[].anomaly.isAnomalous	boolean	是否为异常流量
data.list[].anomaly.score	integer	评分
data.list[].anomaly.signals	array	风险信号列表
data.list[].anomaly.signals[]	string	风险信号
data.list[].verdict	string	判定结果
data.list[].cached	boolean	是否命中缓存
data.list[].headless	object	无头浏览器检测信息
data.list[].headless.isHeadless	boolean	是否为无头浏览器
data.list[].headless.confidence	integer	置信度
data.list[].headless.signals	array	风险信号列表
data.list[].headless.engine	string\|null	无头浏览器引擎（未识别时为 null）
data.list[].risk	object\|null	IP 风险信息（parse 模式恒为 null）
data.list[].ptrDomain	string	PTR 反查到的域名（detect 模式且查到记录时返回）
data.list[].ptrVerified	boolean\|null	PTR 是否验证通过（未触发校验时为 null）
data.list[].asnVerified	boolean\|null	ASN 是否验证通过（未触发校验时为 null）
data.list[].asn	object	ASN 信息（detect 模式且查到记录时返回）
data.list[].asn.asn	string	ASN 编号
data.list[].asn.holder	string	ASN 持有者/运营商名称
data.list[].asn.network	string	ASN 网段
data.list[].headless.signals[]	string	无头浏览器风险信号

请求示例

返回示例

{"msg":"success","code":200,"data":{"list":[{"ua":"Mozilla/5.0 (iPhone; CPU iPhone OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1","bot":{"id":null,"name":null,"isBot":false,"vendor":null,"category":null,"official":false,"aggressive":false,"confidence":0,"categoryName":null},"risk":null,"cached":true,"parsed":{"os":{"name":"iOS","version":"16.0"},"device":{"type":"mobile","brand":"Apple","model":"iPhone"},"browser":{"name":"Safari","engine":"Webkit","version":"16.0"},"isMobile":true,"isDetected":true},"anomaly":{"score":25,"signals":["Missing-Semicolon-Separators"],"isAnomalous":false},"verdict":"human","headless":{"engine":null,"signals":[],"confidence":0,"isHeadless":false},"asnVerified":null,"ptrVerified":null},{"ua":"Mozilla/5.0 (Linux; Android 13; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Mobile Safari/537.36","bot":{"id":null,"name":null,"isBot":false,"vendor":null,"category":null,"official":false,"aggressive":false,"confidence":0,"categoryName":null},"risk":null,"cached":true,"parsed":{"os":{"name":"Android","version":"13"},"device":{"type":"mobile","brand":null,"model":"Pixel 7"},"browser":{"name":"Chrome","engine":"Blink","version":"120"},"isMobile":true,"isDetected":true},"anomaly":{"score":0,"signals":[],"isAnomalous":false},"verdict":"human","headless":{"engine":null,"signals":[],"confidence":0,"isHeadless":false},"asnVerified":null,"ptrVerified":null}],"mode":"parse","total":2,"returned":2,"bot_count":0,"max_limit":10,"truncated":false,"human_count":2,"verdict_dist":{"human":2}}}

产品说明

产品概述

User-Agent 结构化解析与爬虫识别，支持基础解析与风险检测两种模式。

使用场景

数据查询：快速集成 UA 解析与爬虫识别到您的应用中

业务系统：将 UA 解析与爬虫识别数据嵌入业务流程

开发工具：通过 API 接口获取网络工具数据

数据分析：基于 UA 解析与爬虫识别数据进行分析和决策

费用计算

按次计费单价

¥0.001 / 次

每次调用接口从账户余额中扣除相应费用，VIP 用户可享折扣

扣费优先级

免费额度

次数包

余额扣费

计费方式详解

1 免费额度

· 接口每日免费额度已关闭
· VIP 用户月度免费额度：
· 个人版：每月 5000 次，本接口月上限 5000 次
· 专业版：每月 30000 次，本接口月上限 30000 次
· 企业版：每月 200000 次，本接口月上限 200000 次
· 账户如有注册/活动赠送的免费次数，会优先于接口免费额度扣减
· VIP 月度免费额度仅适用于单次售价不高于 ¥0.0800/次的接口；接口每日免费额度按接口配置执行
VIP 月度免费额度每月重置，未使用部分不累计至下月。

2 次数包

预付费购买固定调用次数，最高可省 20%（相对按次付费），用完为止。
次数包为独立计费，不与 VIP 折扣叠加。
请在有效期内使用，过期后未使用的次数不可再用。

3 余额扣费

按次从账户余额扣除费用；所有用户可享量折扣，VIP 用户额外享 VIP 折扣。
扣费公式：实际扣费 = 接口单价 × (1 - VIP 折扣比例 - 量折扣比例)，并受总折扣上限和最低利润率保护约束
VIP 折扣：个人版9折专业版8折企业版7折
量折扣：月付费调用 ≥1000 次享 2%、月付费调用 ≥10000 次享 5%、月付费调用 ≥20000 次享 10%
· 量折扣按账号当月全部接口的付费调用次数统计，达到更高档位时按更高档位计算
总折扣上限：VIP 折扣 + 量折扣合计不超过 50%
最低利润率保护：折后价不得低于成本价 × (1 + 15%)；若接口售价本身低于该保护价，则取消折扣并按售价计费
余额不足时调用将失败，请及时充值。

次数包方案

方案名称	调用次数	价格	折算单价	比按次付费节省	有效期
100次调用包	100 次	¥0.1	¥0.0010/次	-	365 天
500次调用包	500 次	¥0.475	¥0.00095/次	省5%	365 天
1000次调用包	1000 次	¥0.9	¥0.0009/次	省10%	365 天
5000次调用包	5000 次	¥4.25	¥0.00085/次	省15%	365 天
10000次调用包	10000 次	¥8	¥0.0008/次	省20%	365 天

VIP 权益对比

等级	每月免费次数	本接口月免费上限	折扣	VIP 折后单价
免费版	按接口配置	—	-	¥0.001/次
个人版	5000 次	5000 次	10%	¥0.0009/次
专业版	30000 次	30000 次	20%	¥0.0008/次
企业版推荐	200000 次	200000 次	30%	¥0.0007/次

* VIP 月度免费额度每月重置。每月免费次数为账号级 VIP 月额度，本接口月免费上限为其中对本接口的限制（接口可单独设置上限或关闭）。VIP 折扣仅适用于余额扣费方式，VIP 折后单价不含量折扣。本接口已关闭接口级月度免费额度（不影响 VIP 月度免费额度）。接口每日免费额度已关闭。

费用计算示例

* 以下示例未包含量折扣，量折扣按账号当月全部接口的付费调用量另行计算。

示例1：普通用户按次付费

调用 1000 次，费用 = 0.001 × 1000 = ¥1.00

示例2：个人版用户按次付费（仅 VIP 折扣，已考虑最低利润率保护）

调用 1000 次，折扣约 10%，费用 = 0.001 × (1 - 10%) × 1000 ≈ ¥0.90

示例3：购买「500次调用包」次数包

支付 ¥0.475，获得 500 次调用，折算单价 ¥0.00095/次

同等次数按次付费需 ¥0.50，次数包可节省 ¥0.025

错误码说明

错误码	说明	解决方案
200	请求成功	-
400000	请求参数错误	检查参数名、格式与取值
401000	认证失败	检查 Authorization: Bearer 密钥是否正确、是否过期
402000	账户余额不足	充值后重试
403000	无访问权限	确认密钥权限、接口范围与 IP 白名单是否满足要求
404001	接口或端点不存在	检查 API 与端点的请求路径
409000	请求冲突	请稍后重试
422000	参数校验失败	检查参数格式与取值
429000	请求频率或额度超限	降低调用频率，或升级套餐提升额度
500000	服务器内部错误	携带响应中的 request_id 联系技术支持
502000	服务暂时不可用	稍后重试
503000	服务暂时不可用	稍后重试
504000	请求超时	稍后重试

更新日志

暂无更新日志