开发者
开放 API
只读、免鉴权、允许跨域。企业评分、评分分布与用户评价,拿去就能用。
概览
- 基础地址:
https://ok.one,全部为GET,返回 JSON。 - 免鉴权,响应带
Access-Control-Allow-Origin: *,浏览器里可直接调用。 - 机器可读定义:/openapi.json(OpenAPI 3.1);站点导览:/llms.txt;更新订阅:/rss.xml。
- 列表型接口路径以斜杠结尾(否则会收到 308 重定向)。
- 企业页、分类排行页与方法论页支持 markdown 内容协商:请求带
Accept: text/markdown即返回该页的 markdown 表示(含x-markdown-tokens头),token 消耗远低于 HTML。
企业列表
GET https://ok.one/api/companies/?category=electronics_technology&sort=score&limit=60&offset=0category | 分类 id(见分类树接口) |
q | 名称/域名模糊搜索 |
sort | score(默认)| reviews | recent |
limit | 每页条数,最大 100,默认 60 |
offset | 偏移量,默认 0 |
企业详情
GET https://ok.one/api/companies/www.otterbox.comslug 为收录来源记录的企业域名,部分带 www. 前缀(含点,结尾不带斜杠);裸域与 www. 形态只收录了其一时,另一形态的请求会 308 到实际 slug。返回企业信息、最新一页评价、精确星级条数与分页信息。
分类树
GET https://ok.one/api/categories/搜索
GET https://ok.one/api/search/?q=%E9%93%B6%E8%A1%8C&page=1支持中文词跨语言扩展(中文查询词可命中英文公司名)。total 是真实命中总数,data 只是当前页。
字段说明
trustScore | 综合评分,1-5 分 |
distribution | 5→1 星的百分比数组 |
ratingCounts | [5星,4星,3星,2星,1星] 的精确条数 |
updatedAt | 该条数据最后更新时间 |
评分口径与数据来源的完整说明见《评分与数据说明》。
使用条款
数据可用于检索、研究与引用。转载或引用时请注明来源为 OK.one,并链接回对应企业页。请勿高频轮询(接口有共享缓存,同一查询 5 分钟内结果一致)。