API

域名评估接口,免费,无需 API key,无需注册。给开发者,也给 AI Agent。 返回的内容和网页版报告完全一致。

需要 MCP 工具顺序、证据字段语义和机器可读入口?先看新的 NamePico Developers。本页继续保留完整 REST 路径与 curl 参考。

先读这个

所有结论都有边界 —— 商标没有公开查询接口、平台内部风控不对外公开、「可注册」不等于「一定买得到」。 完整的边界说明写在 /llms.txt 的「看不到什么」一节。把结论转述给别人时请一并说明。品牌证据中的 exact_string 只表示某个返回字段出现了精确字符串,不等于精确品牌名; 查询执行完成也不等于品牌调查覆盖完整。

GET/api/d/{域名}

单个域名的完整评估:注册状态、综合判定与全部判据、各渠道价格、历史使用记录、黑名单、同名占用、分用途结论,以及 unknowns(本次没查到的事项)。品牌证据同时给出 matchedText、matchedField、isBrandNameMatch,以及相互独立的 execution、coverage、conclusion。响应最前面有 obtainable 与 advice 两个字段,直接说明这个域名买不买得到 —— 不用自己从 availability 和 verdict 里推断。

curl https://namepico.com/api/d/ipure.dev

# 已注册的域名不会给购买建议:
#   "obtainable": false,
#   "advice": "ipure.dev 已被注册,普通渠道买不到。verdict 里的分数
#              说的是这个域名本身干不干净,不是建议购买。"

GET/api/d/{域名}.txt

同一份报告的纯文本版。不用解析 JSON,适合命令行、日志和只会把页面当文本读的环境。

curl https://namepico.com/api/d/ipure.dev.txt

GET/api/n/{名字}

一个名字在十几个常用后缀下的对比:每个后缀的注册状态、价格与后缀层面的判定,以及推荐的首选。这一层只看后缀;域名自己的历史、黑名单与同名占用要用上面的接口逐个查。

curl https://namepico.com/api/n/ipure

POST/api/v1/domains/check

批量核验:一次最多 20 个名字 × 3 个后缀,或最多 60 个完整域名。只查 RDAP 注册状态,不触发历史、黑名单与同名站点这些慢源。include_price 为 true 时,只对可注册的、最多 10 个域名按域名查溢价与价格。status=unknown 不等于可注册;price.state=unverified 不等于标准价。

curl -X POST https://namepico.com/api/v1/domains/check \
  -H 'content-type: application/json' \
  -d '{"names":["investudy","valuemind"],"tlds":["com"]}'

# 第二段:对入围的可注册域名核验溢价与价格
curl -X POST https://namepico.com/api/v1/domains/check \
  -H 'content-type: application/json' \
  -d '{"domains":["investudy.com"],"include_price":true}'

GET/check/{域名,域名}

批量核验的路径式别名,给不能 POST、也不能带查询参数的 Agent 用。最多 20 个完整域名,默认返回纯文本;加 .json 得 JSON。价格核验请用上面的 POST。

curl https://namepico.com/check/investudy.com,valuemind.io
curl https://namepico.com/check/investudy.com,valuemind.io.json

POST/api/v1/names/overlap

严格字母重合造词:A 的非空后缀与 B 的前缀完全相同,去掉重复段后拼接(invest + study → investudy)。没有重合就不生成,不会把自由融合谎称 overlap。只做规则,不做语义或品牌判断;排序分来自重合长度、总长度与可发音性,是启发式。

curl -X POST https://namepico.com/api/v1/names/overlap \
  -H 'content-type: application/json' \
  -d '{"roots":["invest","study"],"min_length":6,"max_length":9,"min_overlap":2}'

GET/names/overlap/{词根,词根}

重合造词的路径式别名,使用默认参数(长度 6–9、最小重合 2)。默认纯文本,加 .json 得 JSON。

curl https://namepico.com/names/overlap/invest,study
curl https://namepico.com/names/overlap/invest,study.json

读不到上面这些地址?换不带 /api/ 的那组

/report/{域名}(默认纯文本,加 .json 得 JSON)和 /matrix/{名字}.json 返回的是同一份数据、走同一套限流, 只是路径里不带 /api/。

2026-10-19 实测出来的:有的 AI 取数工具读得到 /llms.txt、/openapi.json 和这一页, 偏偏三个 /api/ 开头的地址全读不到 —— 而那三个在我们这边同样是 200、同样的 content-type。 唯一的共同点是前缀,所以配了一组不带前缀的。

curl https://namepico.com/report/ipure.dev
curl https://namepico.com/matrix/ipure.json

机器可读的说明

  • /openapi.json —— OpenAPI 3.1 契约,给工具链读
  • /llms.txt —— 给 AI Agent 读:能回答什么、看不到什么、什么时候该调用
  • 域名详情页的 <head> 里有指向同一份报告 JSON 与纯文本版的 rel=alternate;页面里还内嵌了一份 <script id="domainsense-report" type="application/json">, 打不开接口地址的环境可以直接从 HTML 里取

限流

单域名查询:每个来源每分钟 8 次,每小时 30 份详情报告。批量核验:每个 IP 每小时 300 个域名, 单次最多 20 个名字 × 3 个后缀(或 60 个完整域名);价格核验单次最多 10 个。重合造词:每个 IP 每分钟 30 次。命中十分钟缓存的重复查询不占批量额度。超限返回 429 与 retry-after。

一份报告要向十几个外部数据源发请求,而其中几个是别人家的免费额度。这个上限是为了不把它们耗光 —— 2026 年 10 月被爬虫刷过一次,那两天有几百份报告因此缺了证书历史数据。

关于 robots.txt

/api/、/n/、 /d/、/find 与批量核验的 /check/、/names/ 对搜索引擎爬虫是 Disallow 的 —— 我们不让「谁查过什么名字」变成一份可被检索的公开清单。

但替用户实时取数的 Agent(ChatGPT-User、Claude-User、Perplexity-User 等) 是另一回事:它替某个人查一次,不产生清单。robots.txt 里单列了一组规则对它们放行。 你自己写程序调用不受 robots.txt 约束,遵守上面的限流即可。

接口有问题、字段看不懂、或者希望我们加点什么?说一声。