---
title: "P008 Semantic Search Similar Patent"
method: POST
path: "/search/patent/semantic-search-patent/v2"
tags: ["Patent Data Search"]
---

# P008 Semantic Search Similar Patent

`POST /search/patent/semantic-search-patent/v2`

## Request

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

Receive patent list by semantic search, the maximum number of patents returned is 1000. Sort by default from high to low similarity .Try entering a technical piece of text e.g. an abstract (we recommend entering >200 words for best results).

## Request body

- P008SemanticSearchPatentV2Request
  - `field` string: <p>field sort(only Chinese).field support RELEVANCY,APD,PBD. The default RELEVANCY</p>
  - `order` string: order supports desc,asc. The default desc
  - `simple_legal_status` string: <p>patent simple legal status</p><p>0:Inactive 1:Active 2:Pending 220:PCT designated stage expired 221:PCT designated stage 999:Undetermined, Multiple items can be searched, separated by comma.</p>
  - `text` string, required: semantic query text
  - `country` unknown[]: Authority and kind code. For the Authority code, refer to https://analytics.patsnap.com/status; Kind code is: A (Application), B (Granted Patent), U (Utility Model), D (Design). Multiple items can be searched, separated by comma.
    - unknown
  - `pbd_from` string: Start year of publication date
  - `pbd_to` string: End year of publication date
  - `apd_from` string: Start year of application date
  - `apd_to` string: End year of application date
  - `relevancy` string: relevancy (the relevancy calculated logic can refer to: https://help.patsnap.com/hc/en-us/articles/210698769-What-Is-Semantic-Search-How-Does-It-Work)
  - `offset` integer: offset value; limit + offset <= 20000 (the max number of Semantic Search is 1000)
  - `limit` integer: limit of returned response; must be <= 1,000

## Response `200`

Successful p008 semantic search similar patent response.

- P008SemanticSearchPatentV2Response
  - `data` P008SemanticSearchPatentV2SearchComputeV2Response
    - `results` P008SemanticSearchPatentV2SemanticResult[]: result
      - `pn` string: patent number
      - `apdt` integer: Application Date
      - `apno` string: Application Number
      - `pbdt` integer: Publication Date
      - `title` string: Title
      - `inventor` string: Inventor
      - `patent_id` string: patent id
      - `relevancy` string: relevancy between the result patent and the input content
      - `current_assignee` string: Current Assignee
      - `original_assignee` string: Original Assignee (Applicant)
      - `current_assignee_address` string: Current Assignee Address
      - `original_assignee_address` string: Original Assignee (Applicant) Address
    - `result_count` integer: Received result count
    - `total_search_result_count` integer: Total search result 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)