# eBay Listing Details Scraper - Item Data, Specifics & Seller (`scrapeworks/ebay-listing-details`) Actor Get full eBay listing details in bulk from item IDs or URLs: title, price, condition, item specifics, seller feedback, shipping, returns, sold count and all image URLs as clean JSON. No eBay API key or login needed. - **URL**: https://apify.com/scrapeworks/ebay-listing-details.md - **Developed by:** [Nicolas van Arkens](https://apify.com/scrapeworks) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## eBay Listing Details Scraper — Item Data, Specifics, Seller & Photos **Turn a list of eBay item IDs or URLs into clean, structured listing data.** Paste the links (or IDs) of the eBay listings you care about and get back the full details of each one as JSON: title, price and currency, condition, **every item specific** (Brand, Model, Type, MPN …), the **seller and their feedback**, shipping, returns, item location, sold count, the category breadcrumb and **all high-resolution photo URLs**. No eBay API key, no developer account, no login. This is the zero-setup equivalent of the eBay Browse API's *getItem* endpoint — you bring item IDs/URLs, it returns the listing data. > 🔎 Need to **find** the listings first? Use the **eBay Search Scraper** to turn keywords > into a list of item IDs, then feed those IDs into this actor to enrich each one with the > data only the item page carries (item specifics, full condition text, seller feedback, > every photo). ### What you get (one row per listing) | Field | Description | |---|---| | `itemId` | eBay item ID | | `url` | Canonical listing URL | | `title` | Full listing title | | `price` / `priceValue` / `priceMax` / `currency` | Raw price text, numeric value(s) and currency. Ranges and "or Best Offer" are handled | | `priceConverted` | eBay's approximate price in your local currency, when shown | | `condition` / `conditionDescription` | Short condition (e.g. "Open box") + eBay's full condition note | | `itemSpecifics` | Object of every item-specific the seller filled in (Brand, Model, Type, Size, Color …) | | `seller` | `{ username, url, feedbackScore, positivePercent }` | | `shipping` | Shipping/postage text | | `returns` | Returns policy text | | `itemLocation` | Where the item ships from | | `quantitySold` / `quantityAvailable` | Sold count / quantity available, when displayed | | `breadcrumbs` | Category path, e.g. `["eBay","Jewelry & Watches","Watches",…]` | | `images` / `mainImage` | De-duplicated high-resolution (`s-l1600`) photo URLs for this listing's gallery | | `domain` / `scrapedAt` | Marketplace + ISO timestamp | ### Input Provide listings any way you like — bulk is the point: - **`itemUrls`** — a list of full eBay listing URLs (any marketplace: .com, .co.uk, .de …). - **`itemIds`** — a list of bare numeric item IDs, looked up on the **`domain`** you choose. - **`maxItems`** — safety cap on how many to fetch in one run. - **`proxyConfiguration`** — eBay blocks datacenter traffic, so **Residential** Apify Proxy is strongly recommended. ```json { "itemUrls": [ "https://www.ebay.com/itm/306919649765", "https://www.ebay.co.uk/itm/168393471627" ], "itemIds": ["287371338722"], "domain": "ebay.com", "maxItems": 1000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Output sample ```json { "itemId": "306919649765", "url": "https://www.ebay.com/itm/306919649765", "title": "Antique WWII Era Military Officer's Omega GMT Wristwatch -c.1940 - 48mm- Working", "price": "US $2,764.80 or Best Offer", "priceValue": 2764.8, "currency": "US $", "priceConverted": "Approximately DKK 17,862.27", "condition": "Pre-owned - Good", "seller": { "username": "Riaerica Antiques and Collectables", "url": "https://www.ebay.com/str/riaericaantiquesandcollectables", "feedbackScore": 4777, "positivePercent": 99.5 }, "itemSpecifics": { "Brand": "OMEGA", "Department": "Men", "Type": "Wristwatch", "Country of Origin": "Switzerland" }, "shipping": "Free Standard International Shipping", "returns": "Seller does not accept returns. See details for returns", "itemLocation": "Sofia, Bulgaria", "breadcrumbs": ["eBay", "Jewelry & Watches", "Watches, Parts & Accessories", "Watches", "Wristwatches"], "images": ["https://i.ebayimg.com/images/g/-q0AAOSw6nFoLwai/s-l1600.jpg"], "mainImage": "https://i.ebayimg.com/images/g/-q0AAOSw6nFoLwai/s-l1600.jpg", "domain": "ebay.com", "scrapedAt": "2026-06-14T20:01:19Z" } ``` ### Use cases - **Repricing & competitor monitoring** — track the exact price, condition and seller of a watch-list of listings over time. - **Catalog / product enrichment** — pull item specifics and photos to build or fill out a product database from eBay listings. - **Reseller & sourcing research** — capture seller feedback, item location and the full spec sheet for listings you're evaluating. - **Lead lists** — extract the seller (and their store URL) behind a set of listings. ### FAQ **Do I need an eBay API key or developer account?** No. This reads eBay's public listing pages, so there is nothing to register and no OAuth to manage. **Where do I get item IDs?** They're the 12–13 digit number in any eBay listing URL (`ebay.com/itm/`**`306919649765`**). The companion **eBay Search Scraper** produces them in bulk from keywords. **Which eBay sites are supported?** ebay.com, .co.uk, .de, .com.au, .ca, .fr, .it, .es, .nl, .ie and .in. Item URLs keep their own marketplace; bare IDs use the `domain` you pick. **Why is residential proxy recommended?** eBay blocks datacenter IP addresses. Residential Apify Proxy makes the requests look like a normal browser, which is what reliable results need. **What happens to ended or removed listings?** They're detected (404/410), skipped, and **never charged** — you only pay for listings that return real data. ### Pricing Pay-per-result: you're charged a small fixed fee for **each listing successfully returned**. Blocked, missing or empty pages are never charged. # Actor input Schema ## `itemUrls` (type: `array`): One or more full eBay listing URLs to fetch details for, e.g. 'https://www.ebay.com/itm/168393471627'. Paste as many as you like in a single run - each is fetched and returned as one row. Works with any eBay marketplace URL (.com, .co.uk, .de, ...). You can provide item URLs here, numeric item IDs in 'Item IDs', or both. ## `itemIds` (type: `array`): One or more bare numeric eBay item IDs (the 12-digit number from an eBay listing URL, e.g. '168393471627'). Each is looked up on the marketplace chosen below. Use this when you already have a list of IDs (for example from the eBay Search Scraper) and don't want to build full URLs. ## `domain` (type: `string`): Which eBay site to look up bare item IDs on. Prices are returned in that site's local currency. Item URLs already include their own marketplace, so this only affects IDs entered in 'Item IDs'. Most-used is ebay.com (US). ## `maxItems` (type: `integer`): Safety cap on the total number of listings fetched in one run (across both URLs and IDs). Extra inputs beyond this number are ignored. ## `proxyConfiguration` (type: `object`): Proxy used to reach eBay. eBay blocks datacenter traffic, so RESIDENTIAL Apify Proxy is strongly recommended for reliable results. Defaults to Apify Proxy. ## Actor input object example ```json { "itemUrls": [ "https://www.ebay.com/itm/168393471627", "https://www.ebay.com/itm/306919649765" ], "domain": "ebay.com", "maxItems": 1000, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "itemUrls": [ "https://www.ebay.com/itm/168393471627", "https://www.ebay.com/itm/306919649765" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeworks/ebay-listing-details").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 = { "itemUrls": [ "https://www.ebay.com/itm/168393471627", "https://www.ebay.com/itm/306919649765", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("scrapeworks/ebay-listing-details").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 '{ "itemUrls": [ "https://www.ebay.com/itm/168393471627", "https://www.ebay.com/itm/306919649765" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call scrapeworks/ebay-listing-details --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeworks/ebay-listing-details", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Listing Details Scraper - Item Data, Specifics & Seller", "description": "Get full eBay listing details in bulk from item IDs or URLs: title, price, condition, item specifics, seller feedback, shipping, returns, sold count and all image URLs as clean JSON. No eBay API key or login needed.", "version": "0.1", "x-build-id": "BIHPxgg3yTf8Qh0Mh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeworks~ebay-listing-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeworks-ebay-listing-details", "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/scrapeworks~ebay-listing-details/runs": { "post": { "operationId": "runs-sync-scrapeworks-ebay-listing-details", "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/scrapeworks~ebay-listing-details/run-sync": { "post": { "operationId": "run-sync-scrapeworks-ebay-listing-details", "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": { "itemUrls": { "title": "eBay item URLs", "uniqueItems": true, "type": "array", "description": "One or more full eBay listing URLs to fetch details for, e.g. 'https://www.ebay.com/itm/168393471627'. Paste as many as you like in a single run - each is fetched and returned as one row. Works with any eBay marketplace URL (.com, .co.uk, .de, ...). You can provide item URLs here, numeric item IDs in 'Item IDs', or both.", "items": { "type": "string" } }, "itemIds": { "title": "eBay item IDs", "uniqueItems": true, "type": "array", "description": "One or more bare numeric eBay item IDs (the 12-digit number from an eBay listing URL, e.g. '168393471627'). Each is looked up on the marketplace chosen below. Use this when you already have a list of IDs (for example from the eBay Search Scraper) and don't want to build full URLs.", "items": { "type": "string" } }, "domain": { "title": "eBay marketplace (for bare item IDs)", "enum": [ "ebay.com", "ebay.co.uk", "ebay.de", "ebay.com.au", "ebay.ca", "ebay.fr", "ebay.it", "ebay.es", "ebay.nl", "ebay.ie", "ebay.in" ], "type": "string", "description": "Which eBay site to look up bare item IDs on. Prices are returned in that site's local currency. Item URLs already include their own marketplace, so this only affects IDs entered in 'Item IDs'. Most-used is ebay.com (US).", "default": "ebay.com" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Safety cap on the total number of listings fetched in one run (across both URLs and IDs). Extra inputs beyond this number are ignored.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach eBay. eBay blocks datacenter traffic, so RESIDENTIAL Apify Proxy is strongly recommended for reliable results. Defaults to Apify Proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```