Amazon Public Marketplace Data
Amazon Search By Image MCP
Find visually similar Amazon products from an image URL across eight marketplaces, with optional sales-data enrichment. Call it via REST API or MCP.
Amazon Search By Image AI Prompts & Use Cases
After connecting this MCP tool to your AI assistant, you can ask the questions below. Replace bracketed placeholders with your own inputs and use the supported values in Arguments.
New to Nexscope MCP? Follow the connection guide, then use the prompts below. The Integration and Parameters & Response tabs contain the connection steps, call example, and technical reference.
1. Find Products From An Image
Prompt: Find visually similar Amazon products in [MARKETPLACE] using my public image [IMAGE_URL]. Keep the original provider result format and describe only the returned products.
2. Check Cross-Border Image Matches
Prompt: Find visually similar Amazon products in [MARKETPLACE] using my public image [IMAGE_URL]. Use destination country [DESTINATION_COUNTRY] without a local delivery postal code. Do not use the India marketplace for this cross-border request.
3. Check Results For A Delivery Area
Prompt: Find visually similar Amazon products in [MARKETPLACE] using my public image [IMAGE_URL]. Use delivery postal code [POSTAL_CODE] within the selected marketplace and preserve the delivery context in the summary.
4. Compare Image Matches With Product Data
Prompt: Find Amazon products matching [IMAGE_URL] in [MARKETPLACE]. [INCLUDE_OR_SKIP] the optional sales rank, monthly sales, FBA fee and dimension data; keep unavailable values explicit.
5. Keep The Original Relevance Order
Prompt: Find visually similar Amazon products in [MARKETPLACE] using my public image [IMAGE_URL]. Keep the default relevance order and describe only the returned results.
6. Prioritize Matches By Price
Prompt: Find visually similar Amazon products in [MARKETPLACE] using my public image [IMAGE_URL]. Put [RANKING_PRIORITY] first, choosing lowest price first or highest price first.
7. Prioritize Matches By Ratings Or Review Count
Prompt: Find visually similar Amazon products in [MARKETPLACE] using my public image [IMAGE_URL]. Put [RANKING_PRIORITY] first, choosing lowest rating first, highest rating first, fewest reviews first or most reviews first.
8. Shortlist Ranked Image Matches
Prompt: Find visually similar Amazon products using [PUBLIC_IMAGE_URL] in [MARKETPLACE]. Return a ranked shortlist with product enrichment and the source caveats. Show up to [ONE_TO_100_MATCHES] matches, and treat visual similarity as a research lead rather than proof of the same product.
What You Need to Provide
Replace the bracketed placeholders with your own research inputs. Keep source estimates, reporting periods and missing information explicit.
Choose the original provider result or a ranked shortlist. The ranked shortlist includes enrichment and accepts one to 100 matches; leaving the size unspecified uses 20. Missing product facts remain unavailable.
Step 1 · Connect
Connect Your AI Assistant
Connect a compatible MCP client to Nexscope, then select this tool from your assistant. Use the connection settings in your client to complete authentication.
POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/jsonAuthentication
Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxUsing an API key? Get your key from API Access and include it in the Authorization header shown above.
Call this MCP tool
nexscope_amazon_search_by_imagehttps://api.nexscope.ai/mcptools/callInitialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.
{
"jsonrpc": "2.0",
"id": "amazon-search-by-image-1",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_search_by_image",
"arguments": {
"aggregateByKeepaData": false,
"amazonDomain": "amazon.com",
"imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
}
}
}MCP 2025-11-25 · Streamable HTTPProgress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.
Arguments
| Name | Type | Required | Description |
|---|---|---|---|
imageUrl | string | required | Valid, publicly accessible image URL (maximum 1,000 characters) Example: https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg |
amazonDomain | string | 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 Example: amazon.com |
sort | string | optional | 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 |
deliveryZip | string | optional | 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 |
countryOrAreaCode | string | optional | 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 |
aggregateByKeepaData | boolean | optional | Whether to enrich results with Nexscope data such as sales rank, monthly sales, FBA fees, and dimensions Example: false |
responseFormat | string | optional | raw (default) returns the provider result; matches forces enrichment and returns ranked matches. Example: raw |
topN | integer | optional | Maximum matches in matches mode, clamped to 1-100; default 20. Example: 20 |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
caveats | array | optional | Caveats value used by this API operation. |
caveats[] | string | required | Item in caveats. |
matches | array | optional | Ranked visual matches with optional provider enrichment. |
matches[] | object | required | Item in matches. |
matches[].asin | string | optional | Asin value used by this API operation. |
matches[].estimatedMonthlySales | integer | optional | Estimated monthly sales value used by this API operation. |
matches[].imageUrl | string | optional | Image url value used by this API operation. |
matches[].price | number | optional | Price value used by this API operation. |
matches[].rank | integer | optional | Rank value used by this API operation. |
matches[].rating | number | optional | Rating value used by this API operation. |
matches[].title | string | optional | Title value used by this API operation. |
query | object | optional | Normalized image search query in matches mode. |
Additional documented fields
| Name | Type | Required | Description |
|---|---|---|---|
total | integer | optional | Total number of rows. Example: null |
totalCount | integer | optional | Total quantity. Example: null |
perPage | integer | optional | Quantity per page. Example: null |
currentPage | integer | optional | Current page number. Example: null |
type | string | optional | Rendering style. Example: null |
sourceType | string | optional | Source type. Example: null |
columns | array | optional | Rendered columns. Example: null |
costToken | integer | optional | Consume Token. Example: null |
products | array | optional | Product list. Example: null |
asin | string | optional | ASIN。 Example: null |
title | string | optional | Product title. Example: null |
imageUrl | string | optional | Image URL, that is, the request address. Example: null |
asinUrl | string | optional | Amazon ASIN details URL. Example: null |
price | number | optional | The current price, in the corresponding currency. Example: null |
oldPrice | number | optional | Underline price. Example: null |
currency | string | optional | Currency. Example: null |
rating | number | optional | Current rating, range 0.0–5.0. Example: null |
ratings | integer | optional | Number of ratings. Example: null |
brand | string | optional | brand. Example: null |
sourceType | string | optional | Source type. Example: null |
salesRank | integer | optional | Sales Ranking (KP). Example: null |
salesRank30 | integer | optional | Average sales ranking (KP) over the past 30 days. Example: null |
salesRank90 | integer | optional | Average sales ranking (KP) over the past 90 days. Example: null |
salesRank180 | integer | optional | Average sales ranking (KP) over the past 180 days. Example: null |
monthlySalesUnits | integer | optional | Monthly sales volume (KP). Example: null |
monthlySalesRevenue | number | optional | Monthly sales. Example: null |
reviewCount | integer | optional | Number of comments (KP). Example: null |
fbaFees | number | optional | FBA delivery fee, the unit is the corresponding currency. Example: null |
profit | number | optional | Profit percentage percentage, for example 25.5 means 25.5%. Example: null |
referralFeePercentage | number | optional | Referral fee percentage. Example: null |
fulfillment | string | optional | Delivery method: `AMZ`, `FBA`, `FBM`. Example: null |
primePrice | number | optional | Prime Price. Example: null |
buyBoxSellerId | string | optional | Buy button seller ID. Example: null |
sellerNum | integer | optional | Number of sellers. Example: null |
variationNum | integer | optional | Number of variants. Example: null |
parentAsin | string | optional | Parent ASIN. Example: null |
availableDate | string | optional | Shelf time, in the format of `yyyy-MM-dd HH:mm:ss`. Example: null |
lastUpdate | string | optional | Last updated time, in the format of `yyyy-MM-dd HH:mm:ss`. Example: null |
manufacturer | string | optional | manufacturer. Example: null |
model | string | optional | model. Example: null |
color | string | optional | color. Example: null |
material | string | optional | Product material. Example: null |
weight | string | optional | Weight in grams. Example: null |
dimension | string | optional | size. Example: null |
itemLength | integer | optional | Product length in millimeters; 0 or -1 if not available. Example: null |
itemWidth | integer | optional | Product width in millimeters; 0 or -1 if not available. Example: null |
itemHeight | integer | optional | Product height in millimeters; 0 or -1 if not available. Example: null |
packageLength | integer | optional | Package length in millimeters. Example: null |
packageWidth | integer | optional | Package width in millimeters. Example: null |
packageHeight | integer | optional | Package height in millimeters. Example: null |
packageWeight | string | optional | Packaging weight in grams. Example: null |
packageDimensions | string | optional | Packaging size. Example: null |
packageQuantity | integer | optional | Number of items in the package; 0 or -1 if not available. Example: null |
dimensionsType | string | optional | Size type. Example: null |
categoryTree | string | optional | Category tree. Example: null |
categoryTreeId | string | optional | Category tree ID. Example: null |
rootCategory | integer | optional | Root category ID. Example: null |
isAdultProduct | boolean | optional | Whether it is an adult product. Example: null |
isHazmat | boolean | optional | Whether it is dangerous goods. Example: null |
urlSlug | string | optional | URL Slug。 Example: null |
productImageUrls | array | optional | List of product images. Example: null |
Format Illustration
Illustrative example with fictional data, not a live tool call.
Illustrative Question
Find Amazon US products that look similar to the product in my image.
Illustrative Response Explanation
The illustrative result contains “Example visually similar product”, ASIN B000000001, priced at USD 19.99. Visual similarity alone does not establish that it is the same model or brand.
About this sample: Illustrative example only. Names, identifiers and numbers are fictional; no live tool call was made. Your results depend on your account, inputs and available data.
Published sample data is not available for this page. A format illustration or workflow guide is not a substitute for a published result.
View the MCP Request & Response Format
Examples
Illustrative example with fictional data, not a live tool call.
The JSON-RPC envelope below illustrates how the shown arguments and payload fit into MCP. It is not captured network traffic or proof of a successful call. Workflow-only examples do not include a result.
MCP Request
{
"jsonrpc": "2.0",
"id": "amazon-search-by-image-example",
"method": "tools/call",
"params": {
"name": "nexscope_amazon_search_by_image",
"arguments": {
"aggregateByKeepaData": false,
"amazonDomain": "amazon.com",
"imageUrl": "https://m.media-amazon.com/images/I/31SkgVLWSuL._SL75_.jpg"
}
}
}MCP Response Format
{
"jsonrpc": "2.0",
"id": "amazon-search-by-image-example",
"result": {
"content": [
{
"type": "text",
"text": "{\"code\":0,\"msg\":null,\"data\":{\"total\":1,\"products\":[{\"asin\":\"B000000001\",\"title\":\"Example visually similar product\",\"price\":19.99,\"currency\":\"USD\"}]}}"
}
],
"structuredContent": {
"code": 0,
"msg": null,
"data": {
"total": 1,
"products": [
{
"asin": "B000000001",
"title": "Example visually similar product",
"price": 19.99,
"currency": "USD"
}
]
}
},
"isError": false
}
}