Amazon Marketplace Intelligence

Reverse Product Image Search

Runs the server-side image-search and enrichment workflow without exposing local file paths or intermediate artifacts.

post/api/skill-api/v1/skills/reverse-product-image-search/run

Request

Base URL: https://api.nexscope.ai
URL: https://api.nexscope.ai/api/skill-api/v1/skills/reverse-product-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

imageUrlstring required

Publicly accessible product image URL.

amazonDomainstring required

Amazon marketplace domain.

topNinteger

Maximum number of ranked matches to return after enrichment.

sortstring

Optional provider sort mode.

Example request

{
  "topN": 20,
  "amazonDomain": "amazon.com",
  "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
}

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": {
    "query": {},
    "matches": []
  }
}

Changes

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