---
title: "A001 Application and Issued Trend (keywords & ipc Search & Query Search)"
method: GET
path: "/insights/patent-trends"
tags: ["Technology Key Report"]
---

# A001 Application and Issued Trend (keywords & ipc Search & Query Search)

`GET /insights/patent-trends`

## Request

- Base URL: `https://connect.patsnap.com`
- URL: `https://connect.patsnap.com/insights/patent-trends`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/docs/insights/patent-trends/get.ts> (a function with typed inputs; its response is checked against the schema)

Analyze the annual application trend of the technology. The results include the number of patent applications in the unit of application year, and the number & proportion of patents finally issued in the patents applied for that year. The most recent 20 years of application and issued data are returned.

## Query parameters

- `apply_end_time` string: Patent apply date to, format:yyyy
- `apply_start_time` string: Patent apply date from, format:yyyy
- `authority` string: 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
- `ipc` string: Patent IPC classification
- `keywords` string: Searches for keywords within patent title and summary. Supports AND, OR, NOT search logic, for example "mobile phone AND (screen OR battery)".
- `public_end_time` string: Patent publication date to, format:yyyy
- `public_start_time` string: Patent publication date from, format:yyyy
- `query_text` string: 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

## Response `200`

Successful a001 application and issued trend (keywords & ipc search & query search) response.

- A001InsightsPatentTrendsResponse
  - `data` A001InsightsPatentTrendsPatentTrendResponse[]: response data
    - `values` A001InsightsPatentTrendsPTItemData[]: values
      - `year` string: year
      - `total` integer: total
      - `grant_num` integer: grant number
      - `grant_rate` number, float: grant rate
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found.

---

[API](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api.md) - [All operations](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/revisions/c2264a0de595?raw)