# Scraper by Image - Amazon & Ebay (`devcake/amazon-ebay-scraper`) Actor Reverse image search powered by Amazon Lens and eBay image search. Upload a photo to find similar products with prices, ratings, brands, and listing links - **URL**: https://apify.com/devcake/amazon-ebay-scraper.md - **Developed by:** [devcake](https://apify.com/devcake) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 2 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Marketplace Visual Search Reverse-image search for products on Amazon and eBay. Drop one or many photos, pick the stores, get matches with prices, ratings, and direct links. --- ### 🛒 What It Does Upload or paste image URLs and Marketplace Visual Search sends them to Amazon Lens and eBay image search. Each photo comes back tagged with the store it came from, the product title, price, brand, rating, condition, and a direct link to the listing. Run one store or both in a single pass. --- ### 👥 Who It's For - **Dropshippers and online sellers** — spot a competitor's product in a photo and compare prices across both stores. - **Resellers and thrift flippers** — snap a garage-sale find and instantly see what it sells for and comparable listings. - **Brand protection teams** — catch lookalike products and unauthorized sellers from a reference photo. - **Product researchers** — surface competitors, category leaders, and untapped niches from a single hero image. - **Affiliate marketers** — generate related offers from a hero image to expand articles and comparison pages. --- ### 📊 Data You Get Every row is tagged with `provider` (which store) and `imageLabel` (which input photo), so a single dataset split separates Amazon from eBay and photos from each other. #### From Amazon (`provider: "amazon"`) | Field | Description | |---|---| | `asin` | Amazon Standard Identification Number (10 chars). | | `title` | Product title as listed. | | `byLine` | Brand or seller. | | `price` | Current price. | | `listPrice` | Strike-through list price when discounted. | | `imageUrl` | Thumbnail URL. | | `availability` | Stock status, e.g. `IN_STOCK`. | | `averageOverallRating` | Average star rating (0–5). | | `totalReviewCount` | Number of reviews, e.g. `6,327`. | | `glProductGroup` | Amazon's category code, e.g. `gl_camera`. | | `isEligibleForPrimeShipping` | Whether Prime shipping is available. | | `variation_asins` | Related ASINs (variations and similar products). | | `product_url` | Direct link to the Amazon product page. | #### From eBay (`provider: "ebay"`) | Field | Description | |---|---| | `item_id` | eBay listing ID. | | `title` | Listing title. | | `price` | Asking price. | | `image_url` | Listing thumbnail. | | `condition` | Item condition, e.g. `Pre-Owned`, `Brand New`, `Open Box`. | | `listing_type` | `auction` or `buy_it_now`. | | `list_price` | Strike-through price when discounted. | | `watch_count` | Number of watchers, when shown. | | `sold_count` | Number sold, when shown. | | `bid_count` | Current bids (auctions only). | | `time_left_minutes` | Auction time remaining in minutes. | | `urgency` | Scarcity banner, e.g. `Almost gone`, `Last one`. | | `delivery` | Shipping/delivery text. | | `location` | Item location, e.g. `China`, `United Kingdom`. | | `rating` | Product star rating (0–5), when shown. | | `review_count` | Number of product ratings, when shown. | | `best_offer` | Whether the listing accepts Best Offer. | | `seller` | Seller handle. | | `seller_feedback` | Seller feedback, e.g. `99.9% positive (39.8K)`. | | `free_returns` | Whether free returns are offered. | | `url` | Direct link to the eBay listing. | A built-in status report (the `SUMMARY` key-value store entry) tells you which store succeeded, which came back empty, and if anything failed. If one store can't be reached, the other still ships its results. --- ### 💡 Use Cases #### Run a competitor analysis from a photo Drop in a hero photo of a competitor's product and pull the closest matches from both stores in one pass. Line up prices, ratings, and Prime eligibility without running two separate tools. #### Source wholesale alternatives at a glance A single photo of a retail SKU surfaces sellers and listings for the same product and its closest substitutes. Use the returned codes to feed supplier research or a drop-ship pipeline. #### Track visual trends over time Run a hero image through the tool on a schedule and watch how the visual neighbors shift. Brand names and review counts give a quick read on which lookalikes are gaining traction. #### Enrich a catalog from a photo If a product is missing a description, brand, or category, the Amazon response carries the metadata you need: brand, category, rating, and related codes. #### Catch lookalikes across stores For brand protection or catalog cleanup, run the same image through both stores and compare codes from Amazon to eBay. The `provider` label on every row makes the join trivial. --- ### 🚀 Quick Start 1. **Paste image URLs** into the list, or upload a single image file. 2. **Pick stores** — Amazon, eBay, or both (default: both). 3. **Run** and download the dataset — every match is tagged with the store and the input photo. Most runs finish in under 10 seconds. --- ### ⚙️ Input Parameters | Parameter | Type | Required | Description | |---|---|---|---| | `imageUrls` | array of strings | One of `imageUrls` or `imageFile` required | Public image URLs to search by image. One row per URL in the output. | | `imageFile` | string (file) | One of `imageUrls` or `imageFile` required | Single image upload. Overrides the URLs when provided. | | `provider` | array of strings | No | Which stores to search: `amazon`, `ebay`, or both. Defaults to both. | | `maxResults` | integer | No | Matches per image per store, billed per listing. Minimum and default 27, maximum 200. | --- ### 📝 Example #### Input ```json { "imageUrls": [ "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg" ], "provider": ["amazon", "ebay"], "maxResults": 27 } ```` #### Output One row per match from each store. The dataset contains one row per match, tagged with `provider` (which store it came from) and `imageLabel` (which input photo produced it). **Amazon match:** ```json { "provider": "amazon", "sourceImage": "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg", "imageLabel": "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg", "asin": "B0CCYP6KFM", "title": "eufy Security 3K Dual Camera", "byLine": "eufy Security", "price": "$199.99", "listPrice": null, "imageUrl": "https://m.media-amazon.com/images/I/61QJwdOcJqL.jpg", "availability": "IN_STOCK", "averageOverallRating": 4.2, "totalReviewCount": "6,327", "glProductGroup": "gl_camera", "isEligibleForPrimeShipping": null, "variation_asins": ["B0FF426P7D", "B0FHWNJKNR"], "product_url": "https://www.amazon.com/dp/B0CCYP6KFM" } ``` **eBay match:** ```json { "provider": "ebay", "sourceImage": "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg", "imageLabel": "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg", "item_id": "266392147890", "title": "Vintage Canon AE-1 35mm Film Camera Body - Tested Working", "price": "$89.99", "list_price": null, "condition": "Pre-Owned", "listing_type": "buy_it_now", "image_url": "https://i.ebayimg.com/thumbs/images/g/abc123.jpg", "url": "https://www.ebay.com/itm/266392147890", "seller": "cocosprinkles", "seller_feedback": "99.9% positive (39.8K)", "watch_count": 12, "delivery": "Free International Shipping", "location": "Japan", "free_returns": true, "best_offer": false } ``` Split the dataset by `provider` to see only Amazon or only eBay; split by `imageLabel` to see only one input photo's matches. # Actor input Schema ## `imageUrls` (type: `array`): Paste one or more public image URLs to search by image. One row per URL in the Output tab. ## `imageFile` (type: `string`): Single image upload. Overrides the URLs above when provided. ## `provider` (type: `string`): Pick a store: Amazon, eBay, or both. Default 'Both' searches Amazon and eBay side by side. ## `maxResults` (type: `integer`): How many similar products to return per image, per store. You pay per listing returned, so pick what you need — minimum 27, up to 200. ## Actor input object example ```json { "imageUrls": [ "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg" ], "provider": "both", "maxResults": 27 } ``` # Actor output Schema ## `overview` (type: `string`): Every match from both stores in one table. Filter by 'Store' to see only Amazon or only eBay. ## `amazon` (type: `string`): Only Amazon Lens results — with brand, rating, Prime eligibility. ## `ebay` (type: `string`): Only eBay image-search results — with listing type and free returns. ## `summary` (type: `string`): Per-provider status, counts, and which input image produced which results. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "imageUrls": [ "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg" ] }; // Run the Actor and wait for it to finish const run = await client.actor("devcake/amazon-ebay-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "imageUrls": ["https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg"] } # Run the Actor and wait for it to finish run = client.actor("devcake/amazon-ebay-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "imageUrls": [ "https://m.media-amazon.com/images/I/61Cev2aFG5L._AC_SX695_.jpg" ] }' | apify call devcake/amazon-ebay-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=devcake/amazon-ebay-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Scraper by Image - Amazon & Ebay", "description": "Reverse image search powered by Amazon Lens and eBay image search. Upload a photo to find similar products with prices, ratings, brands, and listing links", "version": "0.1", "x-build-id": "008cD3HniPtXbjgMn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devcake~amazon-ebay-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devcake-amazon-ebay-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/devcake~amazon-ebay-scraper/runs": { "post": { "operationId": "runs-sync-devcake-amazon-ebay-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/devcake~amazon-ebay-scraper/run-sync": { "post": { "operationId": "run-sync-devcake-amazon-ebay-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "imageUrls": { "title": "Image URLs", "type": "array", "description": "Paste one or more public image URLs to search by image. One row per URL in the Output tab.", "items": { "type": "string" } }, "imageFile": { "title": "Or upload an image", "type": "string", "description": "Single image upload. Overrides the URLs above when provided." }, "provider": { "title": "Stores", "enum": [ "both", "amazon", "ebay" ], "type": "string", "description": "Pick a store: Amazon, eBay, or both. Default 'Both' searches Amazon and eBay side by side.", "default": "both" }, "maxResults": { "title": "Match count", "minimum": 27, "maximum": 200, "type": "integer", "description": "How many similar products to return per image, per store. You pay per listing returned, so pick what you need — minimum 27, up to 200.", "default": 27 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```