---
title: "A012 Distribution of technical efficacy phrases"
method: POST
path: "/insights/technology-effect-Distribution"
tags: ["Technology Key Report"]
---

# A012 Distribution of technical efficacy phrases

`POST /insights/technology-effect-Distribution`

## Request

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

By inputting the search formula, query the technical effects of the search formula and the focused technical research directions. It includes: functional phrases, the number of patents covered by the functional phrases, and the number of patents per year (the year of patent application, the number of patents).

## Request body

- A012InsightsTechnologyEffectDistributionRequest
  - `collapse_by` string: <p>"APD" means order according to application date;</p><p>"PBD" means order according to publication date;</p><p>"AUTHORITY" means order according to authority;</p><p>"SCORE" means order according to the relevance score</p>
  - `collapse_order` string: When collapse_type="APNO", and collapse_by="APD" or "PBD", the collapse_order can be set as "OLDEST" or "LATEST", means keep the patent date of oldest or latest one
  - `collapse_order_authority` unknown[]: <p>Setting the patent collapse ordering rule that is valid only if collapse_by is AUTHORITY</p><p>Sets the order of patent collapse according to the input authorities priority list, valid only if collapse_by is AUTHORITY</p>
    - unknown
  - `collapse_type` string: <p>"ALL" or Null value means no collapse;</p><p>"APNO" means collapse according to application number;</p><p>"DOCDB" means collapse according to simple family;</p><p>"INPADOC" means collapse according to inpadoc family;</p><p>"EXTEND" means collapse according to patsnap family</p>
  - `lang` string: Single-choice, available options include "cn" and "en", representing Chinese and English respectively. Please use lowercase letters. The default value is Chinese
  - `query_text` string, required: Analytics query, maximum length 1,500 characters
  - `sort` unknown[]: Field order, field can support: PBDT_YEARMONTHDAY, APD_YEARMONTHDAY, ISD,SCORE; order can support: desc, asc.
    - unknown

## Response `200`

Successful a012 distribution of technical efficacy phrases response.

- A012InsightsTechnologyEffectDistributionResponse
  - `data` A012InsightsTechnologyEffectDistributionTechEffectResponse
    - `tech_effect` A012InsightsTechnologyEffectDistributionTechEffectCountResponse[]: Statistics on the distribution of technical efficacy
      - `name` string: benefit phrase
      - `count` integer: patent count
      - `patent_count_year` A012InsightsTechnologyEffectDistributionTechEffectPatentCountYear[]: Annual statistics of the number of patents covered by functional phrases
        - `count` integer: patent count
        - `pbt_year` integer: patent application year
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `201`: Created.
- `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)