Amazon Marketplace Intelligence

Amazon Search By Image

Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Nexscope enrichment for sales data. Triggered when users mention Amazon image search, Amazon visual search, find similar products on Amazon, reverse image lookup Amazon, Amazon search by photo, or competitor image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find visually matching or similar products on Amazon.

post/api/skill-api/v1/skills/amazon-search-by-image/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/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

Valid, publicly accessible image URL (maximum 1,000 characters)

amazonDomainstring required

Amazon marketplace. Supported domains: United States (amazon.com), United Kingdom (amazon.co.uk), Germany (amazon.de), France (amazon.fr), Italy (amazon.it), Spain (amazon.es), Japan (amazon.co.jp), and India (amazon.in). Default: amazon.com

sortstring

Sort by price, rating, or rating count. Values: default, price-asc-rank, price-desc-rank, rating-asc-rank, rating-desc-rank, ratings-asc-rank, and ratings-desc-rank

deliveryZipstring

Delivery postal code or city within the selected marketplace. If omitted, the marketplace default is used. Maximum 1,000 characters. Defaults: United States=10001, United Kingdom=EC1A 1BB, Germany=10115, France=75001, Italy=00100, Spain=28001, Japan=100-0001, and India=110034

countryOrAreaCodestring

Destination country or region code for cross-border delivery, such as CN, JP, KR, TW, HK, MO, SG, TH, VN, PH, or MY. Do not provide this together with deliveryZip. Amazon India does not support cross-border destination settings. Maximum 1,000 characters

aggregateByKeepaDataboolean

Whether to enrich results with Nexscope data such as sales rank, monthly sales, FBA fees, and dimensions

Example request

{
  "aggregateByKeepaData": false,
  "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": {
    "total": 1,
    "totalCount": 1,
    "perPage": 1,
    "currentPage": 1,
    "costToken": 1,
    "products": []
  }
}

Changes

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