---
title: "A007 Top Assignees"
method: GET
path: "/insights/applicant-ranking"
tags: ["Technology Key Report"]
---

# A007 Top Assignees

`GET /insights/applicant-ranking`

## Request

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

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.

## 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)".
- `lang` string, required: Select the language , the default language is en, you can choose cn or en.
- `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 a007 top assignees response.

- A007InsightsApplicantRankingResponse
  - `data` A007InsightsApplicantRankingApplicantRankingResponse[]: response data
    - `count` integer: patent counts
    - `applicant` string: assignee
    - `percentage` number, double: percentage
  - `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)