|
and Register
Home
Contact Us

Patent Data Search [P060]Image Search Similar Patent - Single image

[P060]Image Search Similar Patent - Single imagePublicV1
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.
Note: Note: 1.Support JPG and PNG, File size limit is 4MB .The similar image path is valid for 9 hour and will be emptied after expiration. 2.This API supports returning Top100 similar patents. If you need to obtain similar patents ranked lower, please pay attention to the setting of the request parameter (offset). 3.If you need to use local images for retrieval, you can first call the [[P010] Image Search Get Image Url] API to obtain the url accessible to the public network by uploading an image.

Basic Information

Resource URL: /search/patent/image-single

Request Mode: post

Return Format: application/json

The API can only be called after logging in, click to log in

API Description Document Download

Request Parameters

body
ImageSearchSingleRequest
ParameterTypeRequiredDescriptionSample
countryarrayfalse
patent authority code For the authority code, refer to https://analytics-patsnap-com.libproxy1.nus.edu.sg/status, Multiple items can be searched, separated by comma.
[ "US", "EU", "CN" ]
locstringfalse

LOC is the classification for Industrial Designs.

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

(14-03 OR 14-02)
offsetintegerfalse
0 <= offset <= 1000, default is 0 If you want to get patents that are ranked lower than 100, you can set offset=100
0
apply_end_timestringfalse
Patent apply date to, format:yyyyMMdd
20200101
assigneesstringfalse
all assignees
huawei
urlstringtrue
image url
https://static-open-zhihuiya-com.libproxy1.nus.edu.sg/sample/common_demo.png
public_end_timestringfalse
Patent publication date to, format:yyyyMMdd
20200101
main_fieldstringfalse

patent main field

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

(phones or 手机)
fieldstringfalse

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

SCORE
public_start_timestringfalse
Patent publication date from, format:yyyyMMdd
20100101
apply_start_timestringfalse
Patent apply date from, format:yyyyMMdd
20100101
limitintegerfalse
Returns the number of patents, 1 <= limit <= 100,default is 10
10
stemmingintegerfalse

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.

0
modelintegertrue

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]

1
patent_typestringtrue

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

D:外观专利

U:实用新型专利

Choose to search design patents or utility model patents:

D: Designs

U: Utility models

D
legal_statusstringfalse

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)

3,2
langstringfalse

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

original
simple_legal_statusstringfalse

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.

1,2
orderstringfalse
order supports desc,asc. The default desc
desc

Request Sample

  • Curl
  • NodeJs
  • Python
  • Java
curl -X POST "https://connect-patsnap-com.libproxy1.nus.edu.sg/search/patent/image-single?apikey="
-H "Content-Type:application/json"
-H "authorization:Bearer {token}"
-d '{"loc":"(14-03 OR 14-02)","url":"https://static-open-zhihuiya-com.libproxy1.nus.edu.sg/sample/common_demo.png","lang":"original","field":"SCORE","limit":10,"model":1,"order":"desc","offset":0,"country":["US","EU","CN"],"stemming":0,"assignees":"huawei","main_field":"(phones or 手机)","patent_type":"D","legal_status":"3,2","apply_end_time":"20200101","public_end_time":"20200101","apply_start_time":"20100101","public_start_time":"20100101","simple_legal_status":"1,2"}'
const axios = require('axios');
const options = {
    url: "https://connect-patsnap-com.libproxy1.nus.edu.sg/search/patent/image-single",
    method: "POST",
    headers: {
        'Content-Type': 'application/json',
        'authorization': 'Bearer {token}',
    },
    params: {
        'apikey': '',
    },
    data: {
        "loc": "(14-03 OR 14-02)",
        "url": "https://static-open-zhihuiya-com.libproxy1.nus.edu.sg/sample/common_demo.png",
        "lang": "original",
        "field": "SCORE",
        "limit": 10,
        "model": 1,
        "order": "desc",
        "offset": 0,
        "country": [
            "US",
            "EU",
            "CN"
        ],
        "stemming": 0,
        "assignees": "huawei",
        "main_field": "(phones or 手机)",
        "patent_type": "D",
        "legal_status": "3,2",
        "apply_end_time": "20200101",
        "public_end_time": "20200101",
        "apply_start_time": "20100101",
        "public_start_time": "20100101",
        "simple_legal_status": "1,2"
    }
};
axios(options).then(res => {
    console.log(res.data)
}).catch(err => {
    console.log(err)
})
import requests
url = "https://connect-patsnap-com.libproxy1.nus.edu.sg/search/patent/image-single"

params = {
    "apikey": ""
}

payload = {
    "loc": "(14-03 OR 14-02)",
    "url": "https://static-open-zhihuiya-com.libproxy1.nus.edu.sg/sample/common_demo.png",
    "lang": "original",
    "field": "SCORE",
    "limit": 10,
    "model": 1,
    "order": "desc",
    "offset": 0,
    "country": [
        "US",
        "EU",
        "CN"
    ],
    "stemming": 0,
    "assignees": "huawei",
    "main_field": "(phones or 手机)",
    "patent_type": "D",
    "legal_status": "3,2",
    "apply_end_time": "20200101",
    "public_end_time": "20200101",
    "apply_start_time": "20100101",
    "public_start_time": "20100101",
    "simple_legal_status": "1,2"
}

headers = {
    "Content-Type": "application/json",
    "authorization": "Bearer {token}"
}

response = requests.request("POST", url, params=params, json=payload, headers=headers)

print(response.text)
public static void main(String[] args) {
    String host = "https://connect-patsnap-com.libproxy1.nus.edu.sg";
    String path = "/search/patent/image-single";

    Map headers = new HashMap();
    headers.put("Content-Type", "application/json");
    headers.put("authorization", "Bearer {token}");

    Map querys = new HashMap();
    querys.put("apikey", "");
    JSONObject dataBody = (JSONObject)JSON.parse("{\"loc\":\"(14-03 OR 14-02)\",\"url\":\"https://static-open-zhihuiya-com.libproxy1.nus.edu.sg/sample/common_demo.png\",\"lang\":\"original\",\"field\":\"SCORE\",\"limit\":10,\"model\":1,\"order\":\"desc\",\"offset\":0,\"country\":[\"US\",\"EU\",\"CN\"],\"stemming\":0,\"assignees\":\"huawei\",\"main_field\":\"(phones or 手机)\",\"patent_type\":\"D\",\"legal_status\":\"3,2\",\"apply_end_time\":\"20200101\",\"public_end_time\":\"20200101\",\"apply_start_time\":\"20100101\",\"public_start_time\":\"20100101\",\"simple_legal_status\":\"1,2\"}");

    try {
        /**
        * Important Tips:
        * Please Download HttpUtils From
        * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
        *
        * Please refer to the corresponding dependence:
        * https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
        */
        HttpResponse response = HttpUtils.doPost(host, path, null, headers, querys, dataBody.toJSONString());
        System.out.println(EntityUtils.toString(response.getEntity()));
    } catch (Exception e) {
        e.printStackTrace();
    }
}
Copy

Response Parameters

CommonResponse
ParameterTypeRequiredDescriptionSample
data
objectfalse
response data
no sample
status
booleantrue
Status
false
error_msg
stringfalse
Error Message
The request parameter format is incorrect!
error_code
integertrue
Error Code
0
ImageSearchResponse
ParameterTypeRequiredDescriptionSample
patent_messages
arrayfalse
similar patent information
Please check the form: PatentMessage
total_search_result_count
integerfalse
number of search results
100
PatentMessage
ParameterTypeRequiredDescriptionSample
url
stringfalse
similar image url
http://patsnap-imagefulltext240.cdn.zhihuiya.com.libproxy1.nus.edu.sg/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240311T111032Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAPEVKZSEKLAJCRYAA%2F20240311%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Signature=017c433982a4c397014bb96c92f320c7da2248a9d6b2ce6352f6adbffc4b0d99
apdt
integerfalse
Application Date
20190528
apno
stringfalse
Application Number
EU006535076
pbdt
integerfalse
Publication Date
20190528
score
numberfalse
similar score (Valid only when sorted by similarity, that is, the request parameter field is SCORE)
0.8884816
title
stringfalse
patent title
Mobile phones
inventor
stringfalse
Inventor
ELSHAFIE, AHMED|YANG, WEI|HOSSEINI, SEYEDKIANOUSH
loc_match
integerfalse
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
1
patent_id
stringfalse
similar patent ID
6e433449-143b-41d9-9abf-6c6519b07779
patent_pn
stringfalse
similar patent number
EU0065350760001S
current_assignee
stringfalse
Current Assignee
HUAWEI TECHNOLOGIES CO., LTD.
original_assignee
stringfalse
Original Assignee (Applicant)
HUAWEI TECHNOLOGIES CO., LTD.

Response Error Details

error_codeDescription
0Success
201Created
401Unauthorized
403Forbidden
404Not Found
68300004Invalid parameter!
68300005Search api failure!
68300006Analytic basic access error!
68300007Bad request!
68300008Service error, please try again later!
68300010The file does not comply with upload specifications!
67200001API call exceeds the total limit set by the platform!
67200002Quota exceeds the limit!
67200003Access token expired or authentication error!
67200004No permission or API package quota has exceeded the limit!
67200005Insufficient balance, call failed!
67200006This client has expired and call failed!
67200007Exceeded the call limit, call failed!

Response Body

  • json
{
    "data": {
        "patent_messages": [
            {
                "url": "http://patsnap-imagefulltext240.cdn.zhihuiya.com.libproxy1.nus.edu.sg/EU/S/00/47/44/21/70/00/9/004744217_0009_0002.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240311T111032Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Credential=AKIAPEVKZSEKLAJCRYAA%2F20240311%2Fcn-northwest-1%2Fs3%2Faws4_request&X-Amz-Signature=017c433982a4c397014bb96c92f320c7da2248a9d6b2ce6352f6adbffc4b0d99",
                "apdt": 20190528,
                "apno": "EU006535076",
                "pbdt": 20190528,
                "score": 0.8884816,
                "title": "Mobile phones",
                "inventor": "ELSHAFIE, AHMED|YANG, WEI|HOSSEINI, SEYEDKIANOUSH",
                "loc_match": 1,
                "patent_id": "6e433449-143b-41d9-9abf-6c6519b07779",
                "patent_pn": "EU0065350760001S",
                "current_assignee": "HUAWEI TECHNOLOGIES CO., LTD.",
                "original_assignee": "HUAWEI TECHNOLOGIES CO., LTD."
            }
        ],
        "total_search_result_count": 100
    },
    "status": true,
    "error_code": 0
}
Copy
[P009]Receive Patent List by Image Search ID V2
[P061]Image Search Similar Patent - Multiple images