---
title: "P038 Market Indicators"
method: GET
path: "/patent-valuation-data/market_indicators"
tags: ["Patent Valuation Data"]
---

# P038 Market Indicators

`GET /patent-valuation-data/market_indicators`

## Request

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

Receive patent market valuation score data by patent_id or patent_number. This includes patent type, family size, family authority count, patent cites count, examiner cites count, and reference cites count.

## Query parameters

- `patent_id` string: patent_id
- `patent_number` string: patent_number

## Response `200`

Successful p038 market indicators response.

- P038PatentValuationDataMarketIndicatorsResponse
  - `data` P038PatentValuationDataMarketIndicatorsPatentMarketValueResponse[]: response data
    - `pn` string: patent number
    - `patent_id` string: patent id
    - `patsnap_market_value` P038PatentValuationDataMarketIndicatorsMarketValue
      - `cites_no` integer: Patent cites count
      - `family_size` integer: Family size
      - `patent_type` string: Patent type:<p>APPLICATION,PATENT,UTILITY,DESIGN</p>
      - `reference_no` integer: Reference cites count
      - `examiner_cites_no` integer: Patent examiner cites count
      - `family_covered_country_no` integer: Family covered authority count
  - `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)