openapi: 3.1.0
info:
title: Patsnap Open Platform AI Translation Technology Key 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: Technology Key Report
description: Technology Key Report APIs.
paths:
/insights/patent-type-trend:
post:
operationId: a011InsightsPatentTypeTrend
summary: A011 Patent Type Trend Analysis
description: Analyze the application trend of different patent types (invention patents, utility models, design patents) within a specified time range.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a011 patent type trend analysis response.
content:
application/json:
schema:
$ref: '#/components/schemas/A011InsightsPatentTypeTrendResponse'
'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/insights/patent-type-trend
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/A011InsightsPatentTypeTrendRequest'
/insights-company/most-cited-latest:
get:
operationId: a106InsightsCompanyMostCitedLatest
summary: A106 Company Most Cited Patents
description: Identify the records in this company's portfolio that have been cited most frequently by other records. These represent more referenced patents that have had their technology built by others. These patents are likely to be more valuable and may represent the more relevant technology to the industry. Returns at most Top 10 patent information.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a106 company most cited patents response.
content:
application/json:
schema:
$ref: '#/components/schemas/A106InsightsCompanyMostCitedLatestResponse'
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights-company/most-cited-latest
parameters:
- name: company_name
in: query
required: false
description: Query the name of a single enterprise
schema:
type: string
example: 华为技术有限公司
description: Query the name of a single enterprise
- name: org_number
in: query
required: false
description: This field is not supported in the current version , please search by company name
schema:
type: string
example: '192203821'
description: This field is not supported in the current version , please search by company name
- name: credit_code
in: query
required: false
description: This field is not supported in the current version , please search by company name
schema:
type: string
example: '914403001922038216'
description: This field is not supported in the current version , please search by company name
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent publication date from, format:yyyy
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: simple_legal_status
in: query
required: false
description: Patent simple legal status<p>0-Inactive</p><p>1-Active</p><p>2-Pending</p><p>220-PCT designated stage expired</p>n<p>221-PCT designated stage</p><p>999-Undetermined</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>
schema:
type: string
example: 1 OR 2
description: Patent simple legal status<p>0-Inactive</p><p>1-Active</p><p>2-Pending</p><p>220-PCT designated stage expired</p>n<p>221-PCT designated stage</p><p>999-Undetermined</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>
- name: patent_type
in: query
required: false
description: 'Patent application type<p>A:Applications</p><p>B: Patents</p><p>U: Utility models</p><p>D: Designs</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>'
schema:
type: string
example: A OR B
description: 'Patent application type<p>A:Applications</p><p>B: Patents</p><p>U: Utility models</p><p>D: Designs</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>'
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.<p>Example: US OR EP</p>'
schema:
type: string
example: CN OR EP
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.<p>Example: US OR EP</p>'
- name: lang
in: query
required: true
description: Select the language , the default language is en, you can choose cn or en.
schema:
type: string
example: en
description: Select the language , the default language is en, you can choose cn or en.
/insights-company/patent-trends:
get:
operationId: a104InsightsCompanyPatentTrends
summary: A104 Company Patent Application and Issued Trend
description: Analyze the annual application trend of the company. This chart shows the number of grants or issued patents resulting from applications filed in the same year, indicating the company's filing success rate over time. The most recent 20 years of application and issued data are returned.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a104 company patent application and issued trend response.
content:
application/json:
schema:
$ref: '#/components/schemas/A104InsightsCompanyPatentTrendsResponse'
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights-company/patent-trends
parameters:
- name: company_name
in: query
required: false
description: Query the name of a single enterprise
schema:
type: string
example: 华为技术有限公司
description: Query the name of a single enterprise
- name: org_number
in: query
required: false
description: This field is not supported in the current version , please search by company name
schema:
type: string
example: '192203821'
description: This field is not supported in the current version , please search by company name
- name: credit_code
in: query
required: false
description: This field is not supported in the current version , please search by company name
schema:
type: string
example: '914403001922038216'
description: This field is not supported in the current version , please search by company name
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent publication date from, format:yyyy
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: simple_legal_status
in: query
required: false
description: Patent simple legal status<p>0-Inactive</p><p>1-Active</p><p>2-Pending</p><p>220-PCT designated stage expired</p>n<p>221-PCT designated stage</p><p>999-Undetermined</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>
schema:
type: string
example: 1 OR 2
description: Patent simple legal status<p>0-Inactive</p><p>1-Active</p><p>2-Pending</p><p>220-PCT designated stage expired</p>n<p>221-PCT designated stage</p><p>999-Undetermined</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>
- name: patent_type
in: query
required: false
description: 'Patent application type<p>A:Applications</p><p>B: Patents</p><p>U: Utility models</p><p>D: Designs</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>'
schema:
type: string
example: A OR B
description: 'Patent application type<p>A:Applications</p><p>B: Patents</p><p>U: Utility models</p><p>D: Designs</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>'
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.<p>Example: US OR EP</p>'
schema:
type: string
example: CN OR EP
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.<p>Example: US OR EP</p>'
/insights-company/simple-legal-status:
get:
operationId: a109InsightsCompanySimpleLegalStatus
summary: A109 Company Patent Simple Legal Status
description: Simple legal status breakdown of the company's portfolio. This tells you the proportion of patents in the portfolio that are in effect, or no longer active, which you can then use to filter by.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a109 company patent simple legal status response.
content:
application/json:
schema:
$ref: '#/components/schemas/A109InsightsCompanySimpleLegalStatusResponse'
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights-company/simple-legal-status
parameters:
- name: company_name
in: query
required: false
description: Query the name of a single enterprise
schema:
type: string
example: 华为技术有限公司
description: Query the name of a single enterprise
- name: org_number
in: query
required: false
description: This field is not supported in the current version , please search by company name
schema:
type: string
example: '192203821'
description: This field is not supported in the current version , please search by company name
- name: credit_code
in: query
required: false
description: This field is not supported in the current version , please search by company name
schema:
type: string
example: '914403001922038216'
description: This field is not supported in the current version , please search by company name
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent publication date from, format:yyyy
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: simple_legal_status
in: query
required: false
description: Patent simple legal status<p>0-Inactive</p><p>1-Active</p><p>2-Pending</p><p>220-PCT designated stage expired</p>n<p>221-PCT designated stage</p><p>999-Undetermined</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>
schema:
type: string
example: 1 OR 2
description: Patent simple legal status<p>0-Inactive</p><p>1-Active</p><p>2-Pending</p><p>220-PCT designated stage expired</p>n<p>221-PCT designated stage</p><p>999-Undetermined</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>
- name: patent_type
in: query
required: false
description: 'Patent application type<p>A:Applications</p><p>B: Patents</p><p>U: Utility models</p><p>D: Designs</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>'
schema:
type: string
example: A OR B
description: 'Patent application type<p>A:Applications</p><p>B: Patents</p><p>U: Utility models</p><p>D: Designs</p><p>Multiple options can be selected, and multiple content items can be spliced with OR (there is a space between parameter and OR)</p>'
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.<p>Example: US OR EP</p>'
schema:
type: string
example: CN OR EP
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.<p>Example: US OR EP</p>'
/insights/portfolio-value:
get:
operationId: a010InsightsPortfolioValue
summary: A010 Portfolio Value Distribution
description: 'Assess the lucrativeness of a technology space based on the spread of estimated patent valuation, with lucrative technologies having a greater proportion of their patent simple families in the higher value buckets.Our valuation method has been developed and implemented by integrating external research published by academics and patent lawyers with our own internal research. We use an underlying set of 80+ different patent indicators (e.g. forward citations, family sizes, patent age, legal status etc.) to compute the valuation, which is adjusted based on the distributions of patent values traded in the past.
Design patents are not valued with this methodology.'
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a010 portfolio value distribution response.
content:
application/json:
schema:
$ref: '#/components/schemas/A010InsightsPortfolioValueResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights/portfolio-value
parameters:
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
schema:
type: string
example: CN
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
- name: ipc
in: query
required: false
description: Patent IPC classification
schema:
type: string
example: B66B11
description: Patent IPC classification
- name: keywords
in: query
required: false
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
schema:
type: string
example: car
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent publication date from, format:yyyy
- name: query_text
in: query
required: false
description: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
schema:
type: string
example: 'TACD: virtual reality'
description: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
/insights/applicant-ranking:
get:
operationId: a007InsightsApplicantRanking
summary: A007 Top Assignees
description: The top companies with the largest patent portfolios in the technology field. Understand who are the largest players and the competitive threats in the technology space. Returns up to the top 10 assignees.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a007 top assignees response.
content:
application/json:
schema:
$ref: '#/components/schemas/A007InsightsApplicantRankingResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights/applicant-ranking
parameters:
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
schema:
type: string
example: CN
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
- name: ipc
in: query
required: false
description: Patent IPC classification
schema:
type: string
example: B66B11
description: Patent IPC classification
- name: keywords
in: query
required: false
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
schema:
type: string
example: car
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
- name: lang
in: query
required: true
description: Select the language , the default language is en, you can choose cn or en.
schema:
type: string
example: en
description: Select the language , the default language is en, you can choose cn or en.
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent publication date from, format:yyyy
- name: query_text
in: query
required: false
description: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
schema:
type: string
example: 'TACD: virtual reality'
description: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
/insights/most-asserted:
get:
operationId: a009InsightsMostAsserted
summary: A009 Most Litigated Patents
description: Identify the patents involved in the most number of litigation cases. This indicates litigation risk associated to patenting in a similar technology space. Returns the Top 10 patents by litigation count.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a009 most litigated patents response.
content:
application/json:
schema:
$ref: '#/components/schemas/A009InsightsMostAssertedResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights/most-asserted
parameters:
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
schema:
type: string
example: CN
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
- name: ipc
in: query
required: false
description: Patent IPC classification
schema:
type: string
example: B66B11
description: Patent IPC classification
- name: keywords
in: query
required: false
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
schema:
type: string
example: car
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent publication date from, format:yyyy
- name: query_text
in: query
required: false
description: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
schema:
type: string
example: 'TACD: virtual reality'
description: Enter the Analytics Query, with a maximum length of 800 characters and cannot contain complex wildcards such as $W $PRE $WS $SEN $PARA $FREQ .etc
/insights/wheel-of-innovation:
get:
operationId: a003InsightsWheelOfInnovation
summary: A003 Wheel of Innovation
description: A two-tiered view of the keywords and phrases found within records in the technology space. This can be used to influence subsequent patent searches by making you aware of the more common terms used in this technology space. It is also useful to identify terms that are commonly associated with other similar terms. The Circle Chart categorizes the most frequently occurring keywords of the most recent 5,000 publications in the technology field into a 2-tier hierarchy.
tags:
- Technology Key Report
security:
- bearerAuth: []
responses:
'200':
description: Successful a003 wheel of innovation response.
content:
application/json:
schema:
$ref: '#/components/schemas/A003InsightsWheelOfInnovationResponse'
'401':
description: Unauthorized.
'403':
description: Forbidden.
'404':
description: Not Found.
externalDocs:
description: API Reference documentation
url: https://open.patsnap.com/devportal/api-reference/insights/wheel-of-innovation
parameters:
- name: apply_end_time
in: query
required: false
description: Patent apply date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent apply date to, format:yyyy
- name: apply_start_time
in: query
required: false
description: Patent apply date from, format:yyyy
schema:
type: string
example: '2010'
description: Patent apply date from, format:yyyy
- name: authority
in: query
required: false
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
schema:
type: string
example: CN
description: 'Select the authority of the patent, the default query all databases, eg CN、US、EP、JP. To find more information, refer to https://analytics.zhihuiya.com/status.
Example: US OR EP'
- name: ipc
in: query
required: false
description: Patent IPC classification
schema:
type: string
example: B66B11
description: Patent IPC classification
- name: keywords
in: query
required: false
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
schema:
type: string
example: car
description: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
- name: lang
in: query
required: true
description: Select the language , the default language is en, you can choose cn or en.
schema:
type: string
example: en
description: Select the language , the default language is en, you can choose cn or en.
- name: public_end_time
in: query
required: false
description: Patent publication date to, format:yyyy
schema:
type: string
example: '2020'
description: Patent publication date to, format:yyyy
- name: public_start_time
in: query
required: false
description: Patent publication dat
# --- truncated at 32 KB (137 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/patsnap/refs/heads/main/openapi/patsnap-technology-key-report-api-openapi.yml