---
title: "P052 Achievement transformation - market prospect indicators"
method: POST
path: "/patent-valuation-data/market_prospect"
tags: ["Patent Valuation Data"]
---

# P052 Achievement transformation - market prospect indicators

`POST /patent-valuation-data/market_prospect`

## Request

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

Receive technology market prospect indicators by similar patents list. there include the highest patent value、industry development、tech application width and the number of original assignee.

## Request body

- P052PatentValuationDataMarketProspectRequest
  - `ipc_cnt_threshold` integer: IPC count threshold, for tech_application_width (default 5)
  - `year_threshold` integer: application year calculation scope, for industry_development (default 3)
  - `patent_info` P052PatentValuationDataMarketProspectTechPatentInfo[], required: <p>List of similar patent information, up to 100 similar patents are supported for indicator calculation.</p><p>Note:</p><p>1. patent_id and pn must have one, if both exist, the patent patent_id will be used first</p><p>2. patent_id or pn must be the patent ID and publication number in Patsnap database</p>
    - `relevancy` string: relevancy between the result patent and the input content
    - `patent_id` string, required: patent id
    - `pn` string, required: patent number

## Response `200`

Successful p052 achievement transformation - market prospect indicators response.

- P052PatentValuationDataMarketProspectResponse
  - `data` P052PatentValuationDataMarketProspectPatentMarketResponse
    - `indicators` P052PatentValuationDataMarketProspectIndicatorsMarket
      - `highest_patent_value` integer: Highest patent value of similar patents
      - `industry_development` unknown[]: Number of patents filed in recent N years under the highest frequency IPC (N is the input parameter)
        - unknown
      - `tech_application_width` integer: Number of similar patents whose number of IPC reached the threshold
      - `original_assignee_count` integer: The number of original assignees for similar patents
    - `patent_info` P052PatentValuationDataMarketProspectPatentInfoMarket[]: Patent information
      - `pn` string, required: patent number
      - `value` integer: patent valuation
      - `ipc_cnt` integer: patent IPC count
      - `patent_id` string, required: patent id
      - `original_assignee_cnt` integer: patent original assignee count
  - `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)
