Patsnap Patsnap Analysis Report API
Patsnap Analysis Report APIs.
Patsnap Analysis Report APIs.
openapi: 3.2.0
info:
title: Patsnap Open Platform AI Translation Patsnap Analysis Report 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: Patsnap Analysis Report
description: Patsnap Analysis Report APIs.
paths:
/innovation/company-report/task/create-no-logo:
post:
operationId: r001TaskCreateNoLogo
summary: R001 Generate Enterprise Report Task (No logo version)
description: According to the enterprise name or unified social credit code, create the enterprise innovation capability report(No Logo), and obtain the report download job ID.<p>The enterprise innovation capability report contains the summary of the enterprise innovation capability, equity penetration analysis, company competitiveness, R&D scale and stability, technology layout, technology quality, technology influence, risk information.</p>
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r001 generate enterprise report task (no logo version) response.
content:
application/json:
schema:
$ref: '#/components/schemas/R001TaskCreateNoLogoResponse'
'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/innovation/company-report/task/create-no-logo
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R001TaskCreateNoLogoRequest'
/innovation/company-report/task/create:
post:
operationId: r001TaskCreate
summary: R001 Generate Enterprise Report Task(Patsnap Logo)
description: According to the enterprise name or unified social credit code, create the enterprise innovation capability report(Patsnap Logo), and obtain the report download ID.<p>The enterprise innovation capability report contains the summary of the enterprise innovation capability, equity penetration analysis, company competitiveness, R&D scale and stability, technology layout, technology quality, technology influence, risk information.</p>
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r001 generate enterprise report task(patsnap logo) response.
content:
application/json:
schema:
$ref: '#/components/schemas/R001TaskCreateResponse'
'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/innovation/company-report/task/create
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R001TaskCreateRequest'
/patent-valuation-data/patent-report/task/create:
post:
operationId: r002TaskCreate
summary: R002 Generate patent value report task(Patsnap Logo)
description: According to the patent number or patent ID, create a patent value report (Patsnap Logo), and obtain the report download job ID.<p>Patent value report, including patent high value labels, patent value evaluation, patent abstract, potential buyer recommendations, patent lifecycle, patent legal events, and other information</p>
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r002 generate patent value report task(patsnap logo) response.
content:
application/json:
schema:
$ref: '#/components/schemas/R002TaskCreateResponse'
'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/patent-valuation-data/patent-report/task/create
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R002TaskCreateRequest'
/patent-valuation-data/patent-report/job_id/status:
get:
operationId: r002JobIdStatus
summary: R002 Query and export patent value report
description: This interface provides patent value report downloading (query and export patent value reports according to the job_id returned in the [R002]Generate patent value report task).
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r002 query and export patent value report response.
content:
application/json:
schema:
$ref: '#/components/schemas/R002JobIdStatusResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/patent-valuation-data/patent-report/job_id/status
parameters:
- name: job_id
in: query
required: false
description: job_id
schema:
type: string
example: '1579434053399035904'
description: job_id
/innovation/company-report/job_id/status:
get:
operationId: r001JobIdStatus
summary: R001 Query and export enterprise report
description: This interface provides enterprise report downloading (query and export reports according to the job_id returned in the Generate Enterprise Report Task)
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r001 query and export enterprise report response.
content:
application/json:
schema:
$ref: '#/components/schemas/R001JobIdStatusResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/innovation/company-report/job_id/status
parameters:
- name: job_id
in: query
required: false
description: job_id
schema:
type: integer
format: int64
example: '1.579434053399036E+18'
description: job_id
/patent-valuation-data/pre_patent-evaluation-create:
post:
operationId: r003PatentValuationDataPrePatentEvaluationCreate
summary: R003 Create Pre-patent Evaluation Report Task
description: Input the technical description text of the patent to be applied for (more than 200 words recommended), create the task of pre-patent evaluation report generation, and return the job id of the report export; The report contains scores and detailed index results for the three dimensions of technological innovation, patentability and translation prospect of the technology solution.
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r003 create pre-patent evaluation report task response.
content:
application/json:
schema:
$ref: '#/components/schemas/R003PatentValuationDataPrePatentEvaluationCreateResponse'
'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/patent-valuation-data/pre_patent-evaluation-create
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R003PatentValuationDataPrePatentEvaluationCreateRequest'
/patent-valuation-data/pre_patent-evaluation-export:
get:
operationId: r003PatentValuationDataPrePatentEvaluationExport
summary: R003 Export Pre-patent Evaluation Report
description: Enter the patent evaluation content to obtain the patent evaluation report job ID
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r003 export pre-patent evaluation report response.
content:
application/json:
schema:
$ref: '#/components/schemas/R003PatentValuationDataPrePatentEvaluationExportResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/patent-valuation-data/pre_patent-evaluation-export
parameters:
- name: job_id
in: query
required: false
description: job_id
schema:
type: string
example: 297e0d32-6c07-48c5-8de5-44efe052bfd1
description: job_id
/search/patent/idea-validation/job_id/status:
post:
operationId: r004-3JobIdStatus
summary: R004-3 Idea Validation - Export Report
description: This interface provides technical idea validation report downloading (query and export technical idea validation report according to the job_id returned in the [R004-1]Idea Validation - Create Report).
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r004-3 idea validation - export report response.
content:
application/json:
schema:
$ref: '#/components/schemas/R004-3JobIdStatusResponse'
'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/search/patent/idea-validation/job_id/status
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R004-3JobIdStatusRequest'
/search/patent/idea-validation/task/create:
post:
operationId: r004-1TaskCreate
summary: R004-1 Idea Validation - Create Report
description: 'According to the technical approach or technical effect, create a technical idea validation report and obtain the report download job ID.
The technical idea validation report contains troubleshooting technical essentials, check scope, list of similar patents, comparison file(technical problems, technical approach, technical effect, comparison of similar features, core invention points, enhancement proposals), analysis results, technical monitoring suggestions.'
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r004-1 idea validation - create report response.
content:
application/json:
schema:
$ref: '#/components/schemas/R004-1TaskCreateResponse'
'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/search/patent/idea-validation/task/create
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R004-1TaskCreateRequest'
/search/patent/idea-validation/similar-patent-comparison:
post:
operationId: r004-2IdeaValidationSimilarPatentComparison
summary: R004-2 Idea Validation - Similar Patent
description: According to the job_id returned in the [R004-1], a list of similar patents can be obtained and compared through semantic search. A maximum of 20 similar patents will be returned, sorted by default from high to low similarity.
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r004-2 idea validation - similar patent response.
content:
application/json:
schema:
$ref: '#/components/schemas/R004-2IdeaValidationSimilarPatentComparisonResponse'
'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/search/patent/idea-validation/similar-patent-comparison
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R004-2IdeaValidationSimilarPatentComparisonRequest'
/patent-valuation-data/patent-report/task/create-no-logo:
post:
operationId: r002TaskCreateNoLogo
summary: R002 Generate patent value report task(No logo)
description: According to the patent number or patent ID, create a patent value report (No Logo), and obtain the report download job ID.<p>Patent value report, including patent high value labels, patent value evaluation, patent abstract, potential buyer recommendations, patent lifecycle, patent legal events, and other information</p>
tags:
- Patsnap Analysis Report
security:
- bearerAuth: []
responses:
'200':
description: Successful r002 generate patent value report task(no logo) response.
content:
application/json:
schema:
$ref: '#/components/schemas/R002TaskCreateNoLogoResponse'
'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/patent-valuation-data/patent-report/task/create-no-logo
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/R002TaskCreateNoLogoRequest'
components:
schemas:
R003PatentValuationDataPrePatentEvaluationCreate_PatentPdfJobResponse:
type: object
properties:
job_id:
type: string
example: b4bdae6b4a65432d91f25b5c52bdfd80
description: Job ID
R002TaskCreateNoLogo_PatentValueReportCreateResponse:
type: object
properties:
job_id:
type: string
example: 1579434053399036000
description: export job id
R004-2IdeaValidationSimilarPatentComparison_SimilarPatent:
type: object
properties:
pn:
type: string
example: CN108001293B
description: Patent publication number
means:
type: array
example:
- sn: 39
passage: 本发明相对于现有技术的技术效果是:电动车辆的原地转向控制系统利用所述车辆控制器根据接收到的原地转向指令控制所述左转向电机控制器和所述右转向电机控制器
section: description
sentence:
- 本发明相对于现有技术的技术效果是:电动车辆的原地转向控制系统利用所述车辆控制器根据接收到的原地转向指令控制所述左转向电机控制器和所述右转向电机控制器
description: List of similar technical means
items:
$ref: '#/components/schemas/R004-2IdeaValidationSimilarPatentComparison_Label'
score:
type: number
format: float
example: 0.94976854
description: Similarity score
efficacy:
type: array
example:
- sn: 43
passage: 本发明所述的有益效果:本发明可以实现车辆的常规行驶、四轮转向、斜行、驻车行驶以及原地中心转向,转向模式丰富,实用性强
section: description
sentence:
- 这是常规车辆所无法实现的;通过车辆的原地中心转向和大转角四轮转向,
- 可以实现车辆更为灵活的变道超车、
description: List of similar technical efficacy
items:
$ref: '#/components/schemas/R004-2IdeaValidationSimilarPatentComparison_Label'
patent_id:
type: string
example: e7b3df69-0f30-4ad3-a753-538e362fd524
description: Patent ID
R002TaskCreateNoLogoRequest:
type: object
properties:
patent_id:
type: string
example: 9cf648f8-8283-4767-9a14-f90f68303f3e
description: Query patent ID, single query
patent_number:
type: string
example: CN108977442B
description: Query patent publication number, single query
report_type:
type: string
example: word
description: Search for the type of patent value report, word or pdf
required:
- report_type
R003PatentValuationDataPrePatentEvaluationCreate_BasicInfo:
type: object
properties:
key:
type: string
example: 检索报告编号
description: Index
value:
type: string
example: Report-20240527-1
description: value
required:
- key
- value
R002JobIdStatus_PatentValueReportExportResponse:
type: object
properties:
job_id:
type: string
example: 1579434053399036000
description: export job id
queue_num:
type: integer
format: int32
example: 10
description: Number of jobs in the queue
job_status:
type: integer
format: int32
example: 1
description: Export status (0:To be exported 1:Exporting. 2:Exporting successfully. 3:Report generation fails.)
download_url:
type: string
example: https://open.patsnap.com/tffi-export/20241126074833/9cf648f8-8283-4767-9a14-f90f68303f3e/CN108977442B_2024_11_26.docx?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDV4ZwCNYgUAwepmojSxCD0c6PXN8mDiBS%26q-sign-time%3D1732607317%3B1733212117%26q-key-time%3D1732607317%3B1733212117%26q-header-list%3Dhost%26q-url-param-list%3Dresponse-content-disposition%26q-signature%3D878962504778cd5fc1228f9dcb76cc735c4dc2c7&response-content-disposition=attachment%3Bfilename%2A%3DUTF-8%27%27CN108977442B_2024_11_26.docx
description: File download link (return if export status is successful)
abnormal_cause:
type: string
example: 由于服务器异常,正在修复中
description: Causes of Exceptions
R004-2IdeaValidationSimilarPatentComparisonRequest:
type: object
properties:
job_id:
type: string
example: 15362c5fae034dfc8943df299afc18b5
description: Query job_id, download technical idea validation report, single query.
required:
- job_id
R002JobIdStatusResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R002JobIdStatus_PatentValueReportExportResponse'
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
R004-3JobIdStatusResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R004-3JobIdStatus_ReportJobStatusResponse'
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
R004-2IdeaValidationSimilarPatentComparison_Docs:
type: object
properties:
similar_patent:
$ref: '#/components/schemas/R004-2IdeaValidationSimilarPatentComparison_SimilarPatent'
R004-2IdeaValidationSimilarPatentComparison_Label:
type: object
properties:
sn:
type: integer
format: int32
example: 39
description: 'Paragraph number of the relevant section. Note: ''0'' represents the paragraph number that is not marked.'
passage:
type: string
example: 本发明相对于现有技术的技术效果是:电动车辆的原地转向控制系统利用所述车辆控制器根据接收到的原地转向指令控制所述左转向电机控制器和所述右转向电机控制器,并所述左转向电机控制器根据接收到的原地转向指令控制所述左前轮转向以及所述右转向电机控制器根据接收到的原地转向控制指令控制所述右前轮转向,且所述左前轮和所述右前轮的转动方向相反且使得所述左前轮和所述右前轮之间形成预设角度的'内八字',由所述转动电机控制向所述车辆控制器发送转向完成指令。
description: Similar passage content
section:
type: string
example: description
description: 'The source of the relevant section, including description and claim. Note: ''description'' refers to the relevant section sourced from the descriptions, ''claim'' refers to the relevant section sourced from the claims.'
sentence:
type: array
example:
- 本发明相对于现有技术的技术效果是:电动车辆的原地转向控制系统利用所述车辆控制器根据接收到的原地转向指令控制所述左转向电机控制器和所述右转向电机控制器,并所述左转向电机控制器根据接收到的原地转向指令控制所述左前轮转向以及所述右转向电机控制器根据接收到的原地转向控制指令控制所述右前轮转向,且所述左前轮和所述右前轮的转动方向相反且使得所述左前轮和所述右前轮之间形成预设角度的'内八字',由所述转动电机控制向所述车辆控制器发送转向完成指令。
description: List of similar sentences
R003PatentValuationDataPrePatentEvaluationExportResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R003PatentValuationDataPrePatentEvaluationExport_PatentPdfDownloadResponse'
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
R002TaskCreateResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R002TaskCreate_PatentValueReportCreateResponse'
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
R001TaskCreate_CompanyReportCreateResponse:
type: object
properties:
job_id:
type: string
example: 1579434053399036000
description: export job id
R001TaskCreateResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R001TaskCreate_CompanyReportCreateResponse'
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
R001TaskCreateNoLogoResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R001TaskCreateNoLogo_CompanyReportCreateResponse'
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
R004-2IdeaValidationSimilarPatentComparisonResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R004-2IdeaValidationSimilarPatentComparison_TechSolutionResearchResponse'
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
R001JobIdStatusResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R001JobIdStatus_CompanyReportExportResponse'
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
R001TaskCreateNoLogoRequest:
type: object
properties:
company_name:
type: string
example: 小米科技有限责任公司
description: Query the name of a single enterprise
credit_code:
type: string
example: 91110108551385082Q
description: Query the unified social credit code of a single enterprise
org_number:
type: string
example: 5513850T82
description: Query the organization code of a single enterprise
report_type:
type: string
example: word
description: Query the type of report returned by the enterprise, either word or pdf
required:
- report_type
R004-1TaskCreateRequest:
type: object
properties:
country:
type: array
example:
- CN
- US
- KR
description: Select the authority of the patent, the default query all databases, eg CN, US, KR.
legal_status:
type: array
example:
- 失效
- 有效
- 审中
- PCT指定期满
- PCT指定期内
- 未确认
description: Simple legal status, default select all, enumerated as follows:Inactive, Active, Pending, PCTdesignated stage, PCTdesignated stage expired, Undetermined
limit:
type: integer
format: int32
example: 5
description: Based on the novelty of the current technical solution, return up to 20 potentially similar patents to generate a search report, with the top 5 patents sorted by similarity selected by default.
tech_effect:
type: string
example: 实现了车辆的原地掉头
description: technical effects
tech_means:
type: string
example: 原地转向控制系统利用车辆控制器根据接收到的原地转向指令控制左转向电机控制器和所述右转向电机控制器,左转向电机控制器根据接收到的原地转向指令控制左前轮转向,右转向电机控制器根据接收到的原地转向控制指令控制右前轮转向,且左前轮和右前轮的转动方向相反使得左前轮和右前轮之间形成预设角度的“内八字”,由转动电机控制向车辆控制器发送转向完成指令。
description: technical means
required:
- tech_means
R004-1TaskCreateResponse:
type: object
properties:
data:
$ref: '#/components/schemas/R004-1TaskCreate_ReportJobCreateResponse'
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
R004-3JobIdStatusRequest:
type: object
properties:
file_format:
type: string
example: ppt
description: 'File format (supports ppt, word), default: ppt'
job_id:
type: string
example: 15362c5fae034dfc8943df299afc18b5
description: Query job_id, download technical idea validation report, single query.
required:
- job_id
R002TaskCreate_PatentValueReportCreateResponse:
type: object
properties:
job_id:
type: string
example: 1579434053399036000
description: export job id
R001JobIdStatus_CompanyReportExportResponse:
type: object
properties:
job_id:
type: integer
format: int64
example: 1579434053399036000
description: export job id
queue_num:
type: integer
format: int32
example: 10
description: Number of jobs in the queue
job_status:
type: integer
format: int32
example: 1
description: Export status (0:To be exported 1:Exporting. 2:Exporting successfully. 3:Report generation fails.)
download_url:
type: string
example: https://open.patsnap.com/tffi-export/20241126074833/9cf648f8-8283-4767-9a14-f90f68303f3e/CN108977442B_2024_11_26.docx?sign=q-sign-algorithm%3Dsha1%26q-ak%3DAKIDV4ZwCNYgUAwepmojSxCD0c6PXN8mDiBS%26q-sign-time%3D1732607317%3B1733212117%26q-key-time%3D1732607317%3B1733212117%26q-header-list%3Dhost%26q-url-param-list%3Dresponse-content-disposition%26q-signature%3D878962504778cd5fc1228f9dcb76cc735c4dc2c7&response-content-disposition=attachment%3Bfilename%2A%3DUTF-8%27%27CN108977442B_2024_11_26.docx
description: File download link (return if export status is successful)
abnormal_cause:
type: string
example: 由于服务器异常,正在修复中
description: Causes of Exceptions
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/patsnap/refs/heads/main/openapi/patsnap-patsnap-analysis-report-api-openapi.yml