OpenAPI Specification
openapi: 3.1.0
info:
title: Patsnap Open Platform AI Translation FTO Search API
version: 1.0.0
description: OpenAPI specification for Patsnap Open Platform APIs, including patent search, analytics, and Eureka AI capabilities.
servers:
- url: https://connect.patsnap.com
description: Patsnap Open Platform API gateway
tags:
- name: FTO Search
description: FTO Search APIs.
paths:
/ai/fto/submit:
post:
operationId: ai66-1FtoSubmit
summary: AI66-1 FTO Search - Create Task
description: Submit technical solution content to initiate an FTO search task. The system will analyze the input technical solution and generate a task ID for subsequent steps.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-1 fto search - create task response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-1FtoSubmitResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/submit
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-1FtoSubmitRequest'
/ai/fto/feature/extract:
post:
operationId: ai66-2FeatureExtract
summary: AI66-2 FTO Search - Extract Technical Features
description: Extract technical features based on the task_id.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-2 fto search - extract technical features response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-2FeatureExtractResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/feature/extract
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-2FeatureExtractRequest'
/ai/fto/feature/confirm:
post:
operationId: ai66-3FeatureConfirm
summary: AI66-3 FTO Search - Confirm Technical Features
description: After the user modifies or adds/reduces technical features from [AI66-2], submit the confirmation to proceed with subsequent retrieval.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-3 fto search - confirm technical features response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-3FeatureConfirmResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/feature/confirm
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-3FeatureConfirmRequest'
/ai/fto/search/agent:
post:
operationId: ai66-4SearchAgent
summary: AI66-4 FTO Search - Start FTO Search
description: Based on the technical features confirmed in [AI66-3], start the FTO search agent to perform patent search.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-4 fto search - start fto search response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-4SearchAgentResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/search/agent
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-4SearchAgentRequest'
/ai/fto/report/create:
post:
operationId: ai66-6ReportCreate
summary: AI66-6 FTO Search - Create Report
description: After the user modifies or adds/reduces the search results from [AI66-5], submit the confirmation and create a complete FTO search report, including all analysis results. Additionally, if the user needs to manually add comparison documents or patents, the output parameters of the [AI66-8] FTO Search - Add Comparison Document or Patent interface can be used as the corresponding part of the input parameters in this interface.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-6 fto search - create report response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-6ReportCreateResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/report/create
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-6ReportCreateRequest'
/ai/fto/report/get:
post:
operationId: ai66-7ReportGet
summary: AI66-7 FTO Search - Download Report
description: Obtain the download link for the generated FTO search report based on the task_id.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-7 fto search - download report response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-7ReportGetResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/report/get
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-7ReportGetRequest'
/ai/fto/feature/comparison:
post:
operationId: ai66-8FeatureComparison
summary: AI66-8 FTO Search - Add Comparison Document or Patent
description: For cases where the user needs to manually add comparison documents or patents, the output parameters of this interface can be used as the corresponding part of the input parameters in [AI66-6] FTO Search - Create Report.
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-8 fto search - add comparison document or patent response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-8FeatureComparisonResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/feature/comparison
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-8FeatureComparisonRequest'
/ai/fto/search/agent/result:
post:
operationId: ai66-5AgentResult
summary: AI66-5 FTO Search - Obtain FTO Search Results
description: Obtain the search results of the FTO search agent based on the task_id confirmed in [AI66-4].
tags:
- FTO Search
security:
- bearerAuth: []
responses:
'200':
description: Successful ai66-5 fto search - obtain fto search results response.
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-5AgentResultResponse'
'201':
description: Created.
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/ai/fto/search/agent/result
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/AI66-5AgentResultRequest'
components:
schemas:
AI66-6ReportCreateResponse:
type: object
properties:
data:
$ref: '#/components/schemas/AI66-6ReportCreate_AsyncTaskIdResponse'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
AI66-5AgentResultRequest:
type: object
properties:
task_id:
type: string
example: 80d440b7-80a5-4233-a75f-ab72b0885c88
description: Task id
required:
- task_id
AI66-8FeatureComparison_FeatureComparisonFinalResFeature:
type: object
properties:
score:
type: integer
format: int32
example: 85
description: Score
public_score:
type: integer
format: int32
example: 90
description: Disclosure score
tech_feature:
type: string
example: 人工智能算法
description: Technical feature
comparison_feature:
type: string
example: 机器学习算法
description: Comparison feature
AI66-5AgentResult_FeatureKeywordItemWord:
type: object
properties:
synonym:
type: array
example:
- 执行
- 运作
- 活动
description: List of synonyms for the feature word
translation:
type: string
example: Operation
description: English translation of the feature word
tech_feature:
type: string
example: 运行
description: Extracted technical feature word (finest granularity)
synonym_score:
type: array
example:
- 95
- 90
- 85
description: List of relevance scores for synonyms, corresponding one-to-one with the synonym list
required:
- tech_feature
AI66-5AgentResult_AiSearchFinalResultFeatureV2:
type: object
properties:
type:
type: string
example: equivalent
description: Feature comparison type label
score:
type: integer
format: int32
example: 100
description: Similarity score between tech feature and comparison feature (0-100)
similar:
type: boolean
example: true
description: Whether similar
claim_num:
type: integer
format: int32
example: 1
description: Claim number (Claim 1, Claim 2, Claim 3, etc.)
claim_type:
type: string
example: independent
description: 'Claim type (independent: independent claim, dependent: dependent claim)'
public_score:
type: number
format: float
example: 0
description: Public disclosure score of the feature
tech_feature:
type: string
example: 一种空调器的除霜控制方法,其特征在于,所述方法为:空调器除霜运行时,获取室外环境风速,检测室外盘管温度
description: Technical feature (from input text)
original_type:
type: string
example: equivalent
description: Original feature comparison type label
type_for_user:
type: string
example: equivalent
description: User-modified feature comparison type label
original_score:
type: integer
format: int32
example: 100
description: Original similarity score
score_for_user:
type: integer
format: int32
example: 95
description: User-modified similarity score
compare_feature:
type: string
example: 除霜运行时,获取室外风速,检测室外盘管温度
description: Compare feature (backup field)
comparison_feature:
type: string
example: 除霜运行时,获取室外风速,检测室外盘管温度。获取室外风速等级对应的除霜退出温度
description: Feature found in comparison document
required:
- score
- tech_feature
AI66-8FeatureComparisonResponse:
type: object
properties:
data:
$ref: '#/components/schemas/AI66-8FeatureComparison_FeatureComparisonResponseDTO'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
AI66-3FeatureConfirmRequest:
type: object
properties:
task_id:
type: string
example: 8b814751-8264-45df-a157-2da6273b07f9
description: Task ID to identify a specific AI search task
tech_features:
type: array
example:
- core: true
score: 100
reason: 包含主题,描述了发明的核心内容。
keywords:
- 空调器
- 除霜控制方法
user_add: false
is_select: true
tech_feature: 空调器及其除霜控制方法
- core: false
score: 70
reason: 结合风速和盘管温度进行除霜控制具有一定的创新性,尤其是在大风天气下的应用。
keywords:
- 除霜运行
- 室外风速
- 室外盘管温度
user_add: false
is_select: true
tech_feature: 除霜运行时,获取室外风速,检测室外盘管温度
- core: false
score: 80
reason: 根据风速调整除霜退出温度是一个创新的控制策略,能够更准确地反映除霜完成的状态。
keywords:
- 室外风速等级
- 除霜退出温度
user_add: false
is_select: true
tech_feature: 获取室外风速等级对应的除霜退出温度(不同风速等级对应不同退出温度,风速越高,退出温度越低)
description: List of technical features confirmed by user, including feature description, keywords, score, selection status and other information
items:
$ref: '#/components/schemas/AI66-3FeatureConfirm_AiSearchAgentFeature'
required:
- task_id
- tech_features
AI66-3FeatureConfirm_AsyncTaskIdResponse:
type: object
properties:
task_id:
type: string
example: 80d440b7-80a5-4233-a75f-ab72b0885c88
description: Task id
AI66-5AgentResult_AiSearchProcessDictItem:
type: object
properties:
cost:
type: number
format: float
example: 108
description: Execution time cost for this round of search (seconds)
status:
type: string
example: success
description: 'Execution status of this round of search (success: successful, failed: failed, running: in progress)'
strategy:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItemStrategy'
find_patent_num:
type: integer
format: int32
example: 7
description: Number of potentially similar patents found in this round of search
comparison_result:
type: array
example:
- score: 91
patent_id: 3f7db6aa-2263-41d5-bddb-671301f215a7
public_score: 1
feature_match_num: 10
description: List of detailed information for potentially similar patents found in this round of search
items:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessComparisonResult'
comparison_patent_num:
type: integer
format: int32
example: 7
description: Total number of patents compared in this round of search
required:
- cost
- status
- strategy
- find_patent_num
- comparison_patent_num
AI66-5AgentResult_AiSearchProcessComparisonResult:
type: object
properties:
score:
type: integer
format: int32
example: 91
description: Overall similarity score between patent and input technical solution (0-100)
patent_id:
type: string
example: 3f7db6aa-2263-41d5-bddb-671301f215a7
description: Patent unique identifier
public_score:
type: number
format: float
example: 1
description: Patent disclosure score indicating the degree of patent information disclosure
find_patent_num:
type: string
example: 7
description: Number of potentially similar patents found in this round of search (string format)
feature_match_num:
type: integer
format: int32
example: 10
description: Number of features matching the input technical solution
required:
- score
- patent_id
- public_score
- feature_match_num
AI66-6ReportCreate_AiSearchFinalResultV2:
type: object
properties:
claim_equivalent_info:
type: array
example:
- claim_num: 1
infringement: true
- claim_num: 2
infringement: true
- claim_num: 3
infringement: true
- claim_num: 4
infringement: true
- claim_num: 5
infringement: true
- claim_num: 6
infringement: true
- claim_num: 7
infringement: true
- claim_num: 8
infringement: true
- claim_num: 9
infringement: true
- claim_num: 10
infringement: true
description: List of claim equivalence information including infringement judgment for each claim
items:
$ref: '#/components/schemas/AI66-6ReportCreate_ClaimEquivalentItem'
claims:
type: array
example:
- claim_num: 1
claim_text: '1.一种空调器的除霜控制方法,其特征在于,所述方法为: 空调器除霜运行时,获取室外环境风速,检测室外盘管温度; 获取室外环境风速所属的风速等级对应的除霜退出温度; 在所述室外盘管温度高于所述室外环境风速所属的风速等级对应的除霜退出温度时,控制所述空调器退出除霜; 其中,不同风速等级对应不同的除霜退出温度,所述风速等级与所述除霜退出温度负相关。 '
- claim_num: 2
claim_text: '2.根据权利要求1所述的空调器的除霜控制方法,其特征在于,所述空调器除霜运行时,根据所述室外环境风速限制压缩机的最高运行频率。 '
- claim_num: 6
claim_text: '6.一种空调器,其特征在于,所述空调器包括: 风速获取模块,用于获取室外环境风速; 室外盘管温度检测模块,用于检测室外盘管温度; 控制模块,用于获取室外环境风速所属的风速等级对应的除霜退出温度,在所述室外盘管温度高于所述室外环境风速所属的风速等级对应的除霜退出温度时,控制所述空调器退出除霜; 存储模块,用于存储风速等级对应的除霜退出温度; 其中,不同风速等级对应不同的除霜退出温度,所述风速等级与所述除霜退出温度负相关。 '
description: List of original claim texts including complete claim content
items:
$ref: '#/components/schemas/AI66-6ReportCreate_FeatureComparisonFinalResClaim'
comparative_literature_type:
type: string
example: A
description: 'Type of comparative literature (A: most relevant prior art)'
comparison_conclusion:
type: object
example:
en: ''
zh: '通过对相关专利各权利要求和标的技术方案的技术特征进行分析可知:
专利权利要求1、2、3、4、5、6、7、8、9、10的技术特征与标的技术方案的技术特征等同,因此权利要求1、2、3、4、5、6、7、8、9、10记载的方案涵盖了标的技术方案,标的技术方案落入权利要求1、2、3、4、5、6、7、8、9、10保护范围。
综上,在2041-03-31之前于CN不建议实施标的技术方案。或在专利到期日前,采取商业合作、授权许可,或做好稳定性分析处置预案后再于相应地区实施。'
description: Comparison conclusion including analysis conclusions in Chinese and English versions
dependent_claim_num:
type: integer
format: int32
example: 8
description: Total number of dependent claims
document:
type: string
example: 一种空调器的除霜控制方法
description: Patent document abstract or key content
equivalent_dependent_claim_num:
type: integer
format: int32
example: 8
description: Number of equivalent dependent claims
equivalent_independent_claim_num:
type: integer
format: int32
example: 2
description: Number of equivalent independent claims
feature_match_num:
type: integer
format: int32
example: 10
description: Number of matched technical features
features:
type: array
example:
- score: 100
reason: ''
similar: true
claim_num: 1
claim_type: independent
public_score: 0
tech_feature: 一种空调器的除霜控制方法,其特征在于,所述方法为:空调器除霜运行时,获取室外环境风速,检测室外盘管温度;获取室外环境风速所属的风速等级对应的除霜退出温度;在所述室外盘管温度高于所述室外环境风速所属的风速等级对应的除霜退出温度时,控制所述空调器退出除霜;其中,不同风速等级对应不同的除霜退出温度,所述风速等级与所述除霜退出温度负相关。
original_score: 100
original_reason: ''
comparison_feature: 除霜运行时,获取室外风速,检测室外盘管温度。获取室外风速等级对应的除霜退出温度(不同风速等级对应不同退出温度,风速越高,退出温度越低)。当室外盘管温度高于对应风速等级的除霜退出温度时,控制空调器退出除霜。
description: List of technical feature comparisons including detailed comparison information for each feature
items:
$ref: '#/components/schemas/AI66-6ReportCreate_AiSearchFinalResultFeatureV2'
independent_claim_num:
type: integer
format: int32
example: 2
description: Total number of independent claims
lang:
type: string
example: CN
description: Patent language
most_similar:
type: boolean
example: false
description: Whether it is the most similar patent
patent_id:
type: string
example: 3f7db6aa-2263-41d5-bddb-671301f215a7
description: Unique patent identifier
public_score:
type: number
format: float
example: 1
description: Disclosure score indicating the degree of patent disclosure
risk_level:
type: string
example: High
description: 'Risk level (High: high risk, Medium: medium risk, Low: low risk)'
selected:
type: boolean
example: true
description: Whether selected for analysis
user_added:
type: boolean
example: false
description: Whether the patent was manually added by the user
required:
- comparison_conclusion
- feature_match_num
- features
- patent_id
- public_score
AI66-5AgentResult_AiSearchProcessDict:
type: object
properties:
ipc_cpc_search:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
semantic_search:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
relevant_tracking_search:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
block_progressive_search_1:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
block_progressive_search_2:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
block_progressive_search_3:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
block_progressive_search_4:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchProcessDictItem'
AI66-3FeatureConfirmResponse:
type: object
properties:
data:
$ref: '#/components/schemas/AI66-3FeatureConfirm_AsyncTaskIdResponse'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
AI66-2FeatureExtract_AiSearchAgentFeature:
type: object
properties:
core:
type: boolean
example: true
description: Whether it is a core field
score:
type: integer
format: int32
example: 80
description: score
reason:
type: string
example: 包含主题,描述了发明的核心内容。
description: reason
keywords:
type: array
example:
- 人形机器人
- 腿部动力结构
description: List of keywords
user_add:
type: boolean
example: true
description: Whether to add for the user
is_select:
type: boolean
example: true
description: Check or not
tech_feature:
type: string
example: 人形机器人的腿部动力结构
description: Extracted feature words
required:
- core
- score
- reason
- keywords
- user_add
- is_select
- tech_feature
AI66-7ReportGet_FtoSearchDownloadResponse:
type: object
properties:
status:
type: integer
format: int32
example: 2
description: 'Export Status (1: Exporting, 2: Export successful, 3: Report generation exception)'
task_id:
type: string
example: d12fcd63d27028b88a73168d5bca44d5
description: task_id of the technical survey report
report_url:
type: string
example: http://downloadurl
description: Report file download link (returned when export status is successful)
AI66-5AgentResultResponse:
type: object
properties:
data:
$ref: '#/components/schemas/AI66-5AgentResult_AiSearchAgentResponse'
status:
type: boolean
example: 'false'
description: Status
error_msg:
type: string
example: The request parameter format is incorrect!
description: Error Message
error_code:
type: integer
example: '0'
description: Error Code
required:
- status
- error_code
AI66-5AgentResult_AiSearchAgentResponse:
type: object
properties:
lang:
type: string
example: CN
description: Language used for search
text:
type: string
example: 空调器及其除霜控制方法
description: Input content used when operation type is expansion, abbreviation, or polishing
cc_num:
type: integer
format: int32
example: 100
description: Number to control algorithm interface token consumption for cost control
cc_pids:
type: array
example:
- 3f7db6aa-2263-41d5-bddb-671301f215a7
- f1f3c8e0-306f-4370-b5ec-9f11c0082e42
description: List of patent IDs involved in feature comparison
task_id:
type: string
example: 9f10932dc8ad173d120adf9a75ad67b5
description: Unique task identifier
is_async:
type: boolean
example: true
description: Whether it is an asynchronous request, consistent with the async parameter in the request
task_cost:
type: number
format: float
example: 366.9
description: Total task execution time in seconds
update_ts:
type: string
example: '2025-10-23 15:44:31.924'
description: Timestamp of the last result update
task_status:
type: string
example: success
description: Current task execution status(running,success)
cc_threshold:
type: number
format: float
example: 60
description: Threshold for feature comparison, above this threshold are confirmed features, below are pending confirmation
excute_times:
type: integer
format: int32
example: 7
description: Number of search executions performed
final_result:
type: array
example:
- lang: CN
features:
- score: 100
similar: true
public_score: 0
tech_feature: 一种空调器的除霜控制方法
comparison_feature: 除霜运行时,获取室外风速,检测室外盘管温度
selected: true
patent_id: 3f7db6aa-2263-41d5-bddb-671301f215a7
risk_level: High
user_added: false
most_similar: false
public_score: 1
feature_match_num: 10
comparative_literature_type: A
description: List of comparison information
# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/patsnap/refs/heads/main/openapi/patsnap-fto-search-api-openapi.yml