---
title: "P062 Create Image Batch Search Task"
method: POST
path: "/search/patent/image-search/single-batch-create"
tags: ["Patent Data Search"]
---

# P062 Create Image Batch Search Task

`POST /search/patent/image-search/single-batch-create`

## Request

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

Support batch uploading of multiple product images (up to 10 images) to create image batch retrieval tasks (retrieval results are the same as [P060] Patent Image Retrieval - Single Image), and return job_id. Batch image retrieval tasks are performed daily from 22:00 to 08:00. After 8:00 the day after requesting job_i, the [P062] interface is called based on job_i to obtain the batch image retrieval results (link to the corresponding interface page URL) and retrieve the retrieval results.

## Request body

- P062ImageSearchSingleBatchCreateRequest
  - `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: <p>field sort(only Chinese).field support SCORE,APD,PBD,ISD. The default SCORE</p>
  - `include_machine_translation` boolean: Includes Machine Translations
  - `is_https` integer: <p>Select whether to return https domain image, default is 0, that is, return http domain image</p><p> 1: Return https</p><p> 0: Return http</p>
  - `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: <p>patent legal status</p><p>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)</p>
  - `limit` integer: Returns the number of patents, 1 <= limit <= 100，default is 10
  - `loc` string: <p>LOC is the classification for Industrial Designs.</p><p>Enter LOC code, use AND/OR/NOT to connect multiple codes.</p>
  - `main_field` string: <p>patent main field</p><p>The main field includes: title, abstract, claims, description, publication number, application number, applicant, inventor and IPC/UPC/LOC classification numbers.</p>
  - `model` integer, required: <p>Select the image search model (there are different models for design patent and utility model)</p><p>Designs:</p><p> 1: Smart Recommendation [recommended]</p><p> 2: Image Search</p><p>Utility models:</p><p> 3: Search by shape only</p><p> 4: Search by shape & color [recommended]</p>
  - `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: <p>选择检索外观专利或实用新型专利：</p><p> D：外观专利</p><p> U：实用新型专利</p>
  - `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: <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>
  - `urls` unknown[], required: image url
    - unknown
  - `stemming` integer: <p>Whether to turn on the stemming function, 1: turn on; 0: turn off. Off by default</p><p>Note: </p><p>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.</p><p>Stemming OFF will only search for exact matches of the keywords entered.</p><p>The use of wildcards in keywords within a search query will impact the effect of stemming.</p><p>Stemming ON only supports English words. Stemming does not apply to Assignees, Inventors, or any other person-related fields.</p>
  - `pre_filter` integer: Whether to turn on the pre_filter function, 1: turn on; 0: turn off. on by default

## Response `200`

Successful p062 create image batch search task response.

- P062ImageSearchSingleBatchCreateResponse
  - `data` P062ImageSearchSingleBatchCreateMoreImageSearchTaskResponse
    - `job_id` string: task id
  - `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)