---
title: "A004 Top authorities of Origin"
method: GET
path: "/insights/priority-country"
tags: ["Technology Key Report"]
---

# A004 Top authorities of Origin

`GET /insights/priority-country`

## Request

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

This shows the authorities in which the earliest application was filed to show the geographic source of the technology. This helps users assess the innovation capability of the authority and can either indicate where a majority of organizations are based, or which authorities company want to first capitalize in. At most, the Top 200 authorities are returned. Other is the sum of all authorities outside the Top 10.

## 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 a004 top authorities of origin response.

- A004InsightsPriorityCountryResponse
  - `data` A004InsightsPriorityCountryPriorityCountryResponse[]: response data
    - `count` integer: patent counts
    - `country` string: Authority name
    - `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)