Nexscope logo
Start free

Amazon Search By Image API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Amazon Marketplace Intelligence

API overview

Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Keepa enrichment for sales data.

Try this API
Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run
MCP method
nexscope_amazon_search_by_image

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run

Run an API

Request parameters documented by ecommerce.amazon-search-by-image.

Slugamazon-search-by-image
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "amazonDomain": "amazon.com",   "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg",   "aggregateByKeepaData": false }'
All categories/ Amazon Marketplace Intelligence
POSThttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run

Run this API

Send a JSON request to execute this API and receive the direct response payload.

Open tester

Endpoint

MethodPOST
Pathhttps://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
imageUrlstringrequired
图片URL地址，请确保图片URL地址有效。最大长度：1000
Example: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg
amazonDomainstringrequired
亚马逊站点，仅支持以下站点：美国(amazon.com)、英国(amazon.co.uk)、德国(amazon.de)、法国(amazon.fr)、意大利(amazon.it)、西班牙(amazon.es)、日本(amazon.co.jp)、印度(amazon.in)。默认 amazon.com
Example: amazon.com
sortstringoptional
排序，支持价格、评分、评论数排序。可选值：default（默认）、price-asc-rank（价格从低到高）、price-desc-rank（价格从高到低）、rating-asc-rank（评分从低到高）、rating-desc-rank（评分从高到低）、ratings-asc-rank（评论数从低到高）、ratings-desc-rank（评论数从高到低）
deliveryZipstringoptional
站内收货地址邮编或城市，如果用户未指定，则取站点（国家）的默认邮编。最大长度：1000。各站点默认邮编：美国=10001、英国=EC1A 1BB、德国=10115、法国=75001、意大利=00100、西班牙=28001、日本=100-0001、印度=110034
countryOrAreaCodestringoptional
站外收货的国家代码（如 CN、JP、KR、TW、HK、MO、SG、TH、VN、PH、MY）。站内邮编地址和站外国家地区代码不能同时指定。注意：印度站不支持设置站外国家或地区收货。最大长度：1000
aggregateByKeepaDatabooleanoptional
是否聚合Keepa数据（销售排名、月销量、FBA费用、尺寸等）
Example: false

Request example

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

Response body

Returns the documented upstream API response directly without an additional wrapper.

NameTypeRequiredDescription
totalintegeroptional
总行数
Example: 1
totalCountintegeroptional
总数量
Example: 1
perPageintegeroptional
每页数量
Example: 1
currentPageintegeroptional
当前页码
Example: 1
typestringoptional
渲染的样式
sourceTypestringoptional
来源类型
columnsarrayoptional
渲染的列
Example: []
costTokenintegeroptional
消耗token
Example: 1
productsarrayoptional
商品列表（详见下方商品字段）
Example: []
asinstringoptional
ASIN
Example: B072MQ5BRX
titlestringoptional
商品标题
imageUrlstringoptional
图片URL（请求地址）
Example: https://example.com/image.jpg
asinUrlstringoptional
亚马逊ASIN的详情网址
Example: B072MQ5BRX
pricenumberoptional
当前价格（单位：元，如美元/欧元等）
Example: 1
oldPricenumberoptional
划线价格
Example: 1
products[].currencystringoptional
币种
ratingnumberoptional
当前评分（0.0-5.0，如4.5星）
Example: 1
ratingsintegeroptional
评分数量
Example: 1
products[].brandstringoptional
品牌
sourceToolstringoptional
来源工具
salesRankintegeroptional
销售排名(keepa)
Example: 1
salesRank30integeroptional
近30天平均销售排名(keepa)
Example: 1
salesRank90integeroptional
近90天平均销售排名(keepa)
Example: 1
salesRank180integeroptional
近180天平均销售排名(keepa)
Example: 1
monthlySalesUnitsintegeroptional
月销量(keepa)
Example: 1
monthlySalesRevenuenumberoptional
月销售额(keepa)
Example: 1
monthlySalesUnits1MonthAgo~monthlySalesUnits12MonthsAgointegeroptional
1~12月前月销量(keepa)
Example: 1
reviewCountintegeroptional
评论数量(keepa)
Example: 1
fbaFeesnumberoptional
FBA配送费(keepa)（单位：元）
Example: 1
profitnumberoptional
利润率(keepa)（利润率百分比，如25.5表示25.5%）
Example: 1
referralFeePercentagenumberoptional
推荐费百分比(keepa)
Example: 1
products[].fulfillmentstringoptional
配送方式(AMZ, FBA, FBM)(keepa)
primePricenumberoptional
Prime价格(keepa)
Example: 1
buyBoxSellerIdstringoptional
购买按钮卖家ID(keepa)
Example: example-id
sellerNumintegeroptional
卖家数(keepa)
Example: 1
variationNumintegeroptional
变体数量(keepa)
Example: 1
parentAsinstringoptional
父ASIN(keepa)
Example: B072MQ5BRX
availableDatestringoptional
上架时间(keepa)（yyyy-MM-dd HH:mm:ss）
Example: 2026-01-01
lastUpdatestringoptional
最后更新时间(keepa)（yyyy-MM-dd HH:mm:ss）
Example: 2026-01-01
products[].manufacturerstringoptional
制造商(keepa)
products[].modelstringoptional
型号(keepa)
products[].colorstringoptional
颜色(keepa)
products[].materialstringoptional
产品的材质(keepa)，指其构造中使用的主要材料
products[].weightstringoptional
重量（克）(keepa)
products[].dimensionstringoptional
尺寸(keepa)
itemLengthintegeroptional
商品长度(keepa)，单位为毫米，不可用时为0或-1
Example: 1
itemWidthintegeroptional
商品宽度(keepa)，单位为毫米，不可用时为0或-1
Example: 1
itemHeightintegeroptional
商品高度(keepa)，单位为毫米，不可用时为0或-1
Example: 1
packageLengthintegeroptional
包装长度（毫米）(keepa)
Example: 1
packageWidthintegeroptional
包装宽度（毫米）(keepa)
Example: 1
packageHeightintegeroptional
包装高度（毫米）(keepa)
Example: 1
products[].packageWeightstringoptional
包装重量（克）(keepa)
products[].packageDimensionsstringoptional
包装尺寸(keepa)
packageQuantityintegeroptional
包装中商品的数量(keepa)，不可用时为0或-1
Example: 1
products[].dimensionsTypestringoptional
尺寸类型(keepa)
products[].categoryTreestringoptional
类目树(keepa)
categoryTreeIdstringoptional
类目树ID(keepa)
Example: example-id
rootCategoryintegeroptional
根类目ID(keepa)
Example: 1
isAdultProductbooleanoptional
是否为成人产品(keepa)
Example: false
isHazmatbooleanoptional
是否为危险品(keepa)
Example: false
urlSlugstringoptional
URL Slug(keepa)
Example: https://example.com/image.jpg
productImageUrlsarrayoptional
商品图片列表(keepa)
Example: []
errcodeintegeroptional
Upstream status code returned by the provider.
errmsgstringoptional
Upstream status message returned by the provider.
codestringoptional
Provider-specific status code.
msgstringoptional
Provider-specific status message.
messagestringoptional
Provider-specific message.
costTimeintegeroptional
Execution time reported by the upstream provider.
pageintegeroptional
Current page returned by the upstream provider.
pageSizeintegeroptional
Page size returned by the upstream provider.
pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
totalPageintegeroptional
Total page count returned by the upstream provider.
dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.

Response example

Direct response payload. No extra wrapper is added.

{
  "total": 1,
  "totalCount": 1,
  "perPage": 1,
  "currentPage": 1,
  "columns": [],
  "costToken": 1,
  "products": [],
  "asin": "B072MQ5BRX",
  "imageUrl": "https://example.com/image.jpg",
  "asinUrl": "B072MQ5BRX",
  "price": 1,
  "oldPrice": 1,
  "rating": 1,
  "ratings": 1,
  "salesRank": 1,
  "salesRank30": 1,
  "salesRank90": 1,
  "salesRank180": 1,
  "monthlySalesUnits": 1,
  "monthlySalesRevenue": 1,
  "monthlySalesUnits1MonthAgo~monthlySalesUnits12MonthsAgo": 1,
  "reviewCount": 1,
  "fbaFees": 1,
  "profit": 1,
  "referralFeePercentage": 1,
  "primePrice": 1,
  "buyBoxSellerId": "example-id",
  "sellerNum": 1,
  "variationNum": 1,
  "parentAsin": "B072MQ5BRX",
  "availableDate": "2026-01-01",
  "lastUpdate": "2026-01-01",
  "itemLength": 1,
  "itemWidth": 1,
  "itemHeight": 1,
  "packageLength": 1,
  "packageWidth": 1,
  "packageHeight": 1,
  "packageQuantity": 1,
  "categoryTreeId": "example-id",
  "rootCategory": 1,
  "isAdultProduct": false,
  "isHazmat": false,
  "urlSlug": "https://example.com/image.jpg",
  "productImageUrls": []
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Related APIs

Amazon Alexa Search

Initiate natural language Q&A through Amazon's storefront Alexa shopping assistant to get shopping guidance answers, recommended product groups, ASIN lists, and follow-up questions. Each call supports only 1 prompt; for follow-ups, the agent must summarize context and concatenate a new question for a new request. A url can be used to supplement Amazon page context.

Amazon Asin Traffic Summary

Use SIF (Search Intelligence Framework) data to analyze ASIN traffic source composition and exposure distribution, covering current period/previous period/newly entered/exited period comparisons.

Amazon Broad Product Search

Use SellerSprite data to search and filter Amazon products, supporting multi-dimensional criteria including price, monthly sales, BSR ranking, gross margin, ratings, fulfillment method, badges, seller origin, and more across multiple Amazon marketplaces.

Amazon Competitor Lookup

Use SellerSprite data to find and analyze competitors on Amazon, covering 12 marketplaces, with product metrics including sales, BSR, pricing, ratings, and growth trends.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_amazon_search_by_image",
    "arguments": {
      "amazonDomain": "amazon.com",
      "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg",
      "aggregateByKeepaData": false
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint
https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run
MCP method
nexscope_amazon_search_by_image
cURL
curl -X POST \
  https://claw-callback.nexscope.ai/api/skill-api/v1/skills/amazon-search-by-image/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "amazonDomain": "amazon.com", "imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg", "aggregateByKeepaData": false }'
Response
No response yet. Run the request to see the response here.