智慧芽开放平台

快速开始

本指南将带您完成第一个专利数据检索 API 请求。我们将使用 query-search-count 接口，它返回匹配您搜索条件的专利总数。

开始之前，请确保您已从管理后台获取 API Key。如果尚未获取，请参阅鉴权指南。

以下是一个搜索"虚拟现实"相关专利的简单示例：

运行请求前，请将 YOUR_API_KEY 替换为您的实际 API Key。

让我们拆解这个请求的关键组成部分：

使用 TACD（文本与代码）语法的搜索查询。TACD: virtual reality 会在标题、摘要、权利要求和说明书字段中搜索包含"虚拟现实"的专利

专利族分组方式。DOCDB 按 DOCDB 专利族分组（同一发明在不同国家的申请）

代表专利族的专利选择方式。PBD（公开日期）选择每个专利族中最早公开的专利

专利族内的排序方式。LATEST 在一个专利族存在多件专利时优先展示最新专利

请求成功后，将返回包含专利数量和查询元数据的 JSON 响应：

响应 200 OK

count— 匹配查询条件的专利总数

query_id— 本次查询的唯一标识符（便于调试）

execution_time_ms— 查询执行时间（毫秒）

401

API 密钥缺失或无效。请检查您在 Authorization 请求头中传入的密钥是否正确

400

请求体格式错误或缺少必填字段。请验证 JSON 格式是否正确，并包含所有必填参数

429

您已超出 API 频率限制。请稍后重试，或升级套餐以获得更高限额

恭喜！您已成功发起第一个 API 请求。接下来可以探索：