DocsSearch API (检索)

Search API

支持自然语言句子的语义专利检索引擎。一次调用即可同时检索中、韩、美、日、欧五国专利。

检索指南

LLM 自然语言检索方法与基于参数的详细检索组合指南请参阅左侧菜单的检索指南。

POST /search

以自然语言检索专利,支持多语言查询(韩语、英语、日语、中文)。

请求参数 (Request Parameters)

参数	类型	必填	默认值	说明
`query`	string	是	—	自然语言检索查询(句式)
`top_k`	integer	否	10	返回结果数 (1–100)
`filters`	object	否	null	检索过滤器(详见下方)
`rerank`	boolean	否	false	是否启用 Cross-encoder 重排序

过滤器选项 (Filter Options)

通过传入 filters 对象来缩小检索结果。

过滤器	类型	示例	说明
`country_codes`	string[]	`["KR","US"]`	国家代码 (KR, US, CN, JP, EP)
`kind_codes`	string[]	`["A1","B2"]`	文档种类代码 (Kind Code)
`applicants`	string[]	`["Samsung"]`	申请人名称(模糊/部分匹配)
`ipc_codes`	string[]	`["H01L21"]`	IPC 分类代码(前缀匹配)
`publication_year_min`	integer	`2020`	最小公开年份
`publication_year_max`	integer	`2025`	最大公开年份
`filing_date_min`	string	`"2023-01-01"`	最小申请日 (YYYY-MM-DD)
`filing_date_max`	string	`"2025-12-31"`	最大申请日 (YYYY-MM-DD)

请求示例 (Request Example)

cURL — Search with filters

curl -X POST https://api.findip.ai/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "query": "lithium ion battery cathode material",
  "top_k": 20,
  "filters": {
    "country_codes": ["US", "KR"],
    "publication_year_min": 2022,
    "publication_year_max": 2025,
    "ipc_codes": ["H01M"]
  }
}'

响应 (Response)

200 OK

{
"results": [
  {
    "publication_id": "US12261291B2",
    "publication_number": "US12261291B2",
    "application_number": "17123456",
    "country_code": "US",
    "kind_code": "B2",
    "score": 0.0317,
    "invention_title": "Positive electrode active material for lithium ion secondary battery",
    "abstract": null,
    "filing_date": "2022-01-15",
    "publication_date": "2025-03-25",
    "ipc_codes": ["H01M 4/525", "H01M 4/36"],
    "applicants": ["COMPANY NAME"],
    "matched_paragraphs": [
      {
        "section": "description",
        "section_name": null,
        "claim_num": null,
        "text": "Examples of materials that have been mainly proposed..."
      }
    ]
  }
],
"total": 20,
"query_time_ms": 1829
}

GET /documents/{publication_id}

获取专利文档完整详情,包含摘要、权利要求、说明书与附图元信息。该端点采用智能识别 (Smart Resolution) — 会自动解析模糊 ID,如有多个候选则返回候选列表。

路径与查询参数 (Path & Query Parameters)

参数	类型	必填	说明
`publication_id`	string (path)	是	文档 ID(例: KR102021000001A, US12261291B2)
`year`	integer (query)	否	公开年份(用于优化数据库查找)
`sections`	string (query)	否	包含的段落: abstract, claims, description 等
`include_figures`	boolean (query)	否	是否包含附图元信息(默认: true)

GET /figures/{publication_id}/{filename}

获取专利附图图片。filename 包含在文档详情响应中。

查询参数 (Query Parameters)

参数	默认值	说明
`size`	full	图片尺寸: thumb (200px), medium (800px), full
`format`	original	输出格式: original, png, jpg

POST /trends

针对特定技术领域进行基于自然语言的专利趋势分析。返回按年份、IPC 分类、申请人、国家的统计聚合数据。

Request

curl -X POST https://api.findip.ai/trends \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "query": "electric vehicle autonomous driving",
  "country_codes": ["KR", "US"],
  "year_min": 2020,
  "year_max": 2025,
  "top_k": 1000,
  "include": ["by_year", "by_ipc", "by_applicant", "by_country"]
}'

POST /stats

使用 SQL 风格的过滤器查询专利统计。与 /trends 不同,该端点无需自然语言查询,直接从数据库进行分组与聚合。

Request

curl -X POST https://api.findip.ai/stats \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "country_codes": ["KR", "US"],
  "year_min": 2020,
  "year_max": 2025,
  "ipc_codes": ["H01M"],
  "group_by": ["year", "ipc"],
  "limit": 10
}'

技术趋势·组合 Next: 认证 (Auth)