--- title: "P060 Image Search Similar Patent - Single image" method: POST path: "/search/patent/image-single" tags: ["Patent Data Search"] --- # P060 Image Search Similar Patent - Single image `POST /search/patent/image-single` ## Request - Base URL: `https://connect.patsnap.com` - URL: `https://connect.patsnap.com/search/patent/image-single` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Image Search helps you search for design patents or utility patents using images. By default, the similarity is sorted from high to low, and one call can return up to 100 similar patents. ## Request body - P060PatentImageSingleRequest - `apply_end_time` string: Patent apply date to, format:yyyyMMdd - `apply_start_time` string: Patent apply date from, format:yyyyMMdd - `assignees` string: all assignees - `country` unknown[]: patent authority code For the authority code, refer to https://analytics.patsnap.com/status, Multiple items can be searched, separated by comma. - unknown - `field` string:

field sort(only Chinese).field support SCORE,APD,PBD,ISD. The default SCORE

- `include_machine_translation` boolean: Includes Machine Translations - `is_https` integer:

Select whether to return https domain image, default is 0, that is, return http domain image

1: Return https

0: Return http

- `lang` string: Set the language preference of the title, you can choose cn, en or original, the default is original: original: Original title cn: Chinese translation title en: English translation Title - `legal_status` string:

patent legal status

1:Published 2:Examining 3:Granted 8:Double 11:Withdrawn 12:Withdrawn-Undetermined 17:Withdrawn-Deemed 18:Withdrawn-Voluntarily 13:Rejected 14:Revoked 15:Expired 16:Non-payment 21:Restoration 22:Ceased 23:P-Revoked 24:Discontinuation 30:Abandoned 19:Abandoned-Deemed 20:Abandoned-Voluntarily 25:Abandoned-Undetermined 222:Non-Entry PCT-NP (In time limit)） 223:PCT-NP (In time limit) 224:PCT-NP (Past time limit) 225:Non-Entry PCT-NP (Past time limit)

- `limit` integer: Returns the number of patents, 1 <= limit <= 100，default is 10 - `loc` string:

LOC is the classification for Industrial Designs.

Enter LOC code, use AND/OR/NOT to connect multiple codes.

- `main_field` string:

patent main field

The main field includes: title, abstract, claims, description, publication number, application number, applicant, inventor and IPC/UPC/LOC classification numbers.

- `model` integer, required:

Select the image search model (there are different models for design patent and utility model)

Designs:

1: Smart Recommendation [recommended]

2: Image Search

Utility models:

3: Search by shape only

4: Search by shape & color [recommended]

- `offset` integer: 0 <= offset <= 1000, default is 0 If you want to get patents that are ranked lower than 100, you can set offset=100 - `order` string: order supports desc,asc. The default desc - `patent_type` string, required:

选择检索外观专利或实用新型专利：

D：外观专利

U：实用新型专利

- `public_end_time` string: Patent publication date to, format:yyyyMMdd - `public_start_time` string: Patent publication date from, format:yyyyMMdd - `return_img_id` boolean: Whether to return img_id - `score_expansion` boolean: Score expansion - `simple_legal_status` string:

patent simple legal status

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.

- `url` string, required: image url - `query_text` string: Analytics query - `stemming` integer:

Whether to turn on the stemming function, 1: turn on; 0: turn off. Off by default

Note:

Stemming ON will search for the original word and expand the search to consider singular, plural, and tense variations e.g. a search for "come" will expand to "comes", "came", "coming" and so on.

Stemming OFF will only search for exact matches of the keywords entered.

The use of wildcards in keywords within a search query will impact the effect of stemming.

Stemming ON only supports English words. Stemming does not apply to Assignees, Inventors, or any other person-related fields.

- `pre_filter` integer: Whether to turn on the pre_filter function, 1: turn on; 0: turn off. on by default ## Response `200` Successful p060 image search similar patent - single image response. - P060PatentImageSingleResponse - `data` P060PatentImageSingleImageSearchExtendResponse - `patent_messages` P060PatentImageSinglePatentExtendMessage[]: similar patent information - `loc` unknown[]: LOC classfication - unknown - `url` string, required: similar image url - `apdt` integer: Application Date - `apno` string: Application Number - `pbdt` integer: Publication Date - `score` number: similar score (Valid only when sorted by similarity, that is, the request parameter field is SCORE) - `title` string, required: patent title - `img_id` string, required: similar image id - `inventor` string: Inventor - `authority` string: Intellectual Property Office - `loc_match` integer: Whether a similar patent hits a high-weight LOC (Valid only when request parameter model is 1 and field is SCORE) 1: hits 0: misses - `patent_id` string, required: similar patent ID - `patent_pn` string, required: similar patent number - `current_assignee` string: Current Assignee - `original_assignee` string: Original Assignee (Applicant) - `total_search_result_count` integer: number of search results - `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)