Patent & IP Risk

Nexscope Utility Patent Image Search

Perform visual similarity search for utility model patents using an image URL, with filtering by country, legal status, date ranges, and assignee. Supports utility model patents only (type U) with shape-only or shape+pattern+color matching models. Triggered when users mention utility patent image search, utility model patent search, utility patent infringement check, product structure patent search, or utility model visual search. Even if the user does not explicitly mention "utility patent," this skill should be triggered whenever the need involves searching for similar utility model patents through an image. For design patents, use ecommerce.zhihuiya-patent-image-search instead.

post/api/skill-api/v1/skills/zhihuiya-utility-patent-image-search/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/zhihuiya-utility-patent-image-search/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

urlstring required

Image URL (maximum 1,000 characters)

patentTypestring required

Patent type: U for a utility model patent. Default: U

modelinteger required

Image-search model. Design patents: 1 (smart association, recommended) or 2 (search this image). Utility model patents: 3 (match shape) or 4 (match shape, pattern, and color; recommended)

countrystring

Patent authority codes for countries, organizations, or regions, separated by commas, for example CN,US,JP. Omit to search all patent authorities

locstring

LOC classifications (Locarno classification numbers). Join multiple classifications with AND, OR, or NOT

legalStatusstring

Comma-separated patent legal-status codes. Values: 1 (published), 2 (substantive examination), 3 (granted), 8 (duplicate-grant avoidance), 11 (withdrawn), 12 (withdrawn-unspecified), 17 (deemed withdrawn), 18 (voluntarily withdrawn), 13 (rejected), 14 (fully revoked), 15 (expired), 16 (annual fee unpaid), 21 (rights restored), 22 (rights terminated), 23 (partially invalid), 24 (application terminated), 30 (abandoned), 19 (deemed abandoned), 20 (voluntarily abandoned), 25 (abandoned-unspecified), 222 (PCT did not enter designated state within designation period), 223 (PCT entered designated state within designation period), 224 (PCT entered designated state after designation period), and 225 (PCT did not enter designated state after designation period)

simpleLegalStatusstring

Comma-separated simplified patent legal-status codes. Values: 0 (inactive), 1 (active), 2 (pending), 220 (PCT designation period expired), 221 (within PCT designation period), and 999 (unconfirmed)

assigneesstring

Applicant or patent owner (maximum 1,000 characters)

applyStartTimestring

Patent application start date in yyyyMMdd format

applyEndTimestring

Patent application end date in yyyyMMdd format

publicStartTimestring

Patent publication start date in yyyyMMdd format

publicEndTimestring

Patent publication end date in yyyyMMdd format

limitinteger

Number of patents to return, from 1 to 100. Default: 10

offsetinteger

Result offset, from 0 to 1,000. Default: 0

fieldstring

Result sort field: SCORE (relevance), APD (application date), PBD (publication date), or ISD (grant date). Default: SCORE

orderstring

Available when field is APD, PBD, or ISD: desc (descending) or asc (ascending). Default: desc

langstring

Preferred title language: original (original patent title), cn (Chinese-translated title), or en (English-translated title). Default: original

preFilterinteger

Whether to enable country/LOC pre-filtering: 1 for enabled and 0 for disabled. Default: 1

stemminginteger

Whether to enable stemming: 1 for enabled and 0 for disabled. Default: 0

mainFieldstring

Primary patent fields, including title, abstract, claims, specification, publication number, application number, applicant, inventor, and IPC/UPC/LOC classifications (maximum 1,000 characters)

includeMachineTranslationboolean

Include machine-translated data in the search

scoreExpansionboolean

Score expansion

isHttpsinteger

Whether to return images over HTTPS: 1 for HTTPS and 0 for HTTP. Default: 0

returnImgIdboolean

Whether to return img_id. Default: false

Example request

{
  "country": "US",
  "url": "https://m.media-amazon.com/images/I/719mRAn2VrL._AC_SL1500_.jpg",
  "patentType": "U",
  "model": 4,
  "preFilter": 1,
  "isHttps": 1,
  "limit": 5,
  "stemming": 0,
  "offset": 0
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "total": 1,
    "allRecordsCount": 1,
    "data": [],
    "costToken": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.