{ "data": { "id": "2aHfLR6En16iBh6bc", "actId": "ue8AF0IdZnL8KILaW", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-11-09T06:39:05.349Z", "finishedAt": "2026-11-09T06:39:15.110Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 9677, "runTimeSecs": 9.677, "computeUnits": 0.010752222222222222, "imageSizeBytes": 332563456 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"eBay Item, Store & Store Category Detail Input\",\n \"description\": \"Choose what to scrape — item pages, a seller store inventory, one store category, or keyword search — then set marketplace and result limits.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"What to scrape\",\n \"type\": \"string\",\n \"description\": \"Item details opens the item pages you list. Store inventory walks a seller's whole store. Store category walks one category inside a store. Keyword search finds matching listings.\",\n \"editor\": \"select\",\n \"enum\": [\n \"item\",\n \"store\",\n \"storeCategory\",\n \"search\"\n ],\n \"enumTitles\": [\n \"Item details — open specific item pages\",\n \"Store inventory — every active listing in a seller store\",\n \"Store category — one category inside a seller store\",\n \"Keyword search — listings matching your terms\"\n ],\n \"default\": \"search\",\n \"prefill\": \"search\",\n \"sectionCaption\": \"Mode\"\n },\n \"itemIds\": {\n \"title\": \"Item IDs or URLs\",\n \"type\": \"array\",\n \"description\": \"eBay item IDs (for example 257633093777) or full /itm/ links. Used in Item details mode.\",\n \"editor\": \"stringList\",\n \"default\": []\n },\n \"storeNames\": {\n \"title\": \"Store names or URLs\",\n \"type\": \"array\",\n \"description\": \"Seller store names (for example discountcomputerdepot) or /str/ store links. Used in Store inventory mode.\",\n \"editor\": \"stringList\",\n \"default\": []\n },\n \"storeCategoryUrls\": {\n \"title\": \"Store category URLs\",\n \"type\": \"array\",\n \"description\": \"Store-category links copied from a store page, for example https://www.ebay.com/str/mystore/Laptops/_i.html?store_cat=1234567890. Used in Store category mode.\",\n \"editor\": \"stringList\",\n \"default\": []\n },\n \"searchQueries\": {\n \"title\": \"Search keywords\",\n \"type\": \"array\",\n \"description\": \"Keywords to search on the selected marketplace. One search per entry. Used in Keyword search mode.\",\n \"editor\": \"stringList\",\n \"default\": [],\n \"prefill\": [\n \"laptop\"\n ]\n },\n \"startUrls\": {\n \"title\": \"Paste any eBay URLs (optional shortcut)\",\n \"type\": \"array\",\n \"description\": \"Paste item, store, store-category, category-browse or search links and each is routed to the right mode automatically. Ignored when the arrays above already cover that source.\",\n \"editor\": \"requestListSources\",\n \"default\": []\n },\n \"marketplace\": {\n \"title\": \"Marketplace\",\n \"type\": \"string\",\n \"description\": \"Country site used for names and keywords, and for any input that is not already a full URL. The dropdown carries the legacy full-URL values; short codes (US, GB, DE, FR, IT, ES, CA, AU) are also accepted by API callers.\",\n \"editor\": \"select\",\n \"enum\": [\n \"https://www.ebay.com\",\n \"https://www.ebay.co.uk\",\n \"https://www.ebay.de\",\n \"https://www.ebay.fr\",\n \"https://www.ebay.it\",\n \"https://www.ebay.es\",\n \"https://www.ebay.ca\",\n \"https://www.ebay.com.au\"\n ],\n \"enumTitles\": [\n \"United States (ebay.com)\",\n \"United Kingdom (ebay.co.uk)\",\n \"Germany (ebay.de)\",\n \"France (ebay.fr)\",\n \"Italy (ebay.it)\",\n \"Spain (ebay.es)\",\n \"Canada (ebay.ca)\",\n \"Australia (ebay.com.au)\"\n ],\n \"default\": \"https://www.ebay.com\",\n \"prefill\": \"https://www.ebay.com\",\n \"sectionCaption\": \"Marketplace & filters\"\n },\n \"condition\": {\n \"title\": \"Item condition\",\n \"type\": \"string\",\n \"description\": \"Filter keyword-search results by condition. Leave on All conditions for every condition.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"new\",\n \"openBox\",\n \"manufacturerRefurbished\",\n \"refurbished\",\n \"used\",\n \"forParts\"\n ],\n \"enumTitles\": [\n \"All conditions\",\n \"New\",\n \"Open box\",\n \"Manufacturer refurbished\",\n \"Seller refurbished\",\n \"Used\",\n \"For parts or not working\"\n ],\n \"default\": \"\"\n },\n \"buyingFormat\": {\n \"title\": \"Buying format\",\n \"type\": \"string\",\n \"description\": \"Show only Buy It Now or auction listings in keyword-search results.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"buyItNow\",\n \"auction\"\n ],\n \"enumTitles\": [\n \"Buy It Now & auctions\",\n \"Buy It Now only\",\n \"Auctions only\"\n ],\n \"default\": \"\"\n },\n \"minPrice\": {\n \"title\": \"Minimum price\",\n \"type\": \"number\",\n \"description\": \"Filter keyword-search results by minimum item price in the marketplace's local currency.\",\n \"editor\": \"number\",\n \"minimum\": 0,\n \"maximum\": 1000000000\n },\n \"maxPrice\": {\n \"title\": \"Maximum price\",\n \"type\": \"number\",\n \"description\": \"Filter keyword-search results by maximum item price in the marketplace's local currency.\",\n \"editor\": \"number\",\n \"minimum\": 0,\n \"maximum\": 1000000000\n },\n \"sortBy\": {\n \"title\": \"Sort order\",\n \"type\": \"string\",\n \"description\": \"How to order keyword-search results.\",\n \"editor\": \"select\",\n \"enum\": [\n \"bestMatch\",\n \"priceLowest\",\n \"priceHighest\",\n \"endingSoonest\",\n \"newlyListed\"\n ],\n \"enumTitles\": [\n \"Best match\",\n \"Price: lowest first\",\n \"Price: highest first\",\n \"Ending soonest\",\n \"Newly listed\"\n ],\n \"default\": \"bestMatch\"\n },\n \"freeShipping\": {\n \"title\": \"Free shipping only\",\n \"type\": \"boolean\",\n \"description\": \"Keep only keyword-search results that advertise free shipping or delivery.\",\n \"default\": false,\n \"prefill\": false\n },\n \"returnsAccepted\": {\n \"title\": \"Returns accepted only\",\n \"type\": \"boolean\",\n \"description\": \"Keep only keyword-search results that accept returns.\",\n \"default\": false,\n \"prefill\": false\n },\n \"itemLocation\": {\n \"title\": \"Item location\",\n \"type\": \"string\",\n \"description\": \"Keep keyword-search results located in the marketplace country, or show worldwide results.\",\n \"editor\": \"select\",\n \"enum\": [\n \"\",\n \"domestic\",\n \"worldwide\"\n ],\n \"enumTitles\": [\n \"Any location\",\n \"Domestic only\",\n \"Worldwide\"\n ],\n \"default\": \"\"\n },\n \"maxItems\": {\n \"title\": \"Max records\",\n \"type\": \"integer\",\n \"description\": \"Upper limit on item records across every source.\",\n \"default\": 3,\n \"prefill\": 2,\n \"minimum\": 1,\n \"maximum\": 10000,\n \"sectionCaption\": \"Result limits\"\n },\n \"maxPages\": {\n \"title\": \"Max pages per source\",\n \"type\": \"integer\",\n \"description\": \"Stop after this many listing pages per store, category or search. Each page holds up to 240 listings.\",\n \"default\": 10,\n \"prefill\": 1,\n \"minimum\": 1,\n \"maximum\": 200\n },\n \"includeItemDetails\": {\n \"title\": \"Open each listing for full item details\",\n \"type\": \"boolean\",\n \"description\": \"When on, every discovered listing is opened and returns the full item record (specifics, images, seller, shipping, returns). Turn off for a faster card-level result from search and store pages.\",\n \"default\": true,\n \"prefill\": true\n },\n \"includeItemSpecifics\": {\n \"title\": \"Include the item-specifics table\",\n \"type\": \"boolean\",\n \"description\": \"Add the full item-specifics table (brand, model, MPN, dimensions, features and other aspects) to item records.\",\n \"default\": true,\n \"prefill\": true\n }\n }\n}", "readme": "# eBay Item, Store & Store Category Detail Extractor\n\nOpen eBay item pages, walk a seller's entire store, or crawl one store category, and get complete item-detail records: item specifics, every high-resolution image, seller and store trust signals, stock and sales counts, shipping terms and return policy.\n\nThe actor reads public eBay pages only. No cookie, login, API key or proxy setup is required — paste a URL or a name and run.\n\n## What can it scrape?\n\n| Mode | Start with | What you get |\n|------|-----------|--------------|\n| **Item details** | Item IDs or `/itm/` links | One full record per listing |\n| **Store inventory** | Store names or `/str/` links | The store's active listings, paginated, each opened for full details |\n| **Store category** | Store-category links | One category inside a store, paginated, each listing opened for full details |\n| **Keyword search** | Plain keywords | Matching listings, paginated, each opened for full details |\n\nAll four modes share one result budget (`maxItems`) and one page budget per source (`maxPages`). Discovery is paginated automatically: search pages, store fronts and store categories are walked until the budget is reached, the source runs out of pages, or a page returns no new item IDs.\n\n## Input\n\n| Field | Type | Default | Description |\n|-------|------|---------|-------------|\n| `mode` | Select | `search` | Item details, Store inventory, Store category, or Keyword search |\n| `itemIds` | Array | – | Item IDs (`257633093777`) or full `/itm/` links |\n| `storeNames` | Array | – | Store names (`discountcomputerdepot`) or `/str/` links |\n| `storeCategoryUrls` | Array | – | Store-category links such as `https://www.ebay.com/str/mystore/Laptops/_i.html?store_cat=1234567890` |\n| `searchQueries` | Array | – | Keywords, one search per entry |\n| `startUrls` | Array | – | Optional shortcut: paste any eBay URL and it is routed to the right mode |\n| `marketplace` | Select | `https://www.ebay.com` | One of 8 country sites (US, UK, DE, FR, IT, ES, CA, AU). The dropdown keeps the legacy full-URL values; API callers may also send `US`, `GB`, etc. |\n| `condition` | Select | All | New, Open box, Manufacturer refurbished, Seller refurbished, Used, For parts |\n| `buyingFormat` | Select | `\"\"` | Buy It Now only or Auctions only |\n| `minPrice` / `maxPrice` | Number | – | Price range in the marketplace currency |\n| `sortBy` | Select | `bestMatch` | Best match, price low/high, ending soonest, newly listed |\n| `freeShipping` | Boolean | `false` | Keep only free-shipping listings |\n| `returnsAccepted` | Boolean | `false` | Keep only listings that accept returns |\n| `itemLocation` | Select | Any | Domestic-only or worldwide |\n| `maxItems` | Integer | `3` | Total records across every source |\n| `maxPages` | Integer | `10` | Listing pages per store, category or search (up to 240 listings each) |\n| `includeItemDetails` | Boolean | `true` | Open each discovered listing for the full item record; turn off for faster card-level results |\n| `includeItemSpecifics` | Boolean | `true` | Include the item-specifics table and seller notes |\n\nCondition, buying-format, price, sort, shipping, returns and item-location filters apply to **Keyword search** results. Store and Store category modes walk the seller's inventory in its own order.\n\n### Supported URL shapes\n\n- Item: `https://www.ebay.com/itm/267153498498`\n- Item with slug: `https://www.ebay.com/itm/Product-Title-Here/267153498498`\n- Store: `https://www.ebay.com/str/thriftbooks`\n- Store category: `https://www.ebay.com/str/thriftbooks/Fiction/_i.html?store_cat=261186`\n- Search: `https://www.ebay.co.uk/sch/i.html?_nkw=laptop`\n- Category browse: `https://www.ebay.com/b/PC-Laptops-Netbooks/177`\n\n### Example: item details\n\n```json\n{\n \"mode\": \"item\",\n \"itemIds\": [\"257633093777\"],\n \"maxItems\": 1\n}\n```\n\n### Example: store category\n\n```json\n{\n \"mode\": \"storeCategory\",\n \"storeCategoryUrls\": [\n \"https://www.ebay.com/str/discountcomputerdepot/Laptops/_i.html?store_cat=10748275017\"\n ],\n \"maxItems\": 20,\n \"maxPages\": 2\n}\n```\n\n### Example: keyword search\n\n```json\n{\n \"mode\": \"search\",\n \"searchQueries\": [\"iphone 15 pro\", \"pixel 9\"],\n \"marketplace\": \"https://www.ebay.co.uk\",\n \"condition\": \"used\",\n \"maxItems\": 50,\n \"maxPages\": 3\n}\n```\n\n## Output\n\nEvery record is an item-detail record when `includeItemDetails` is on. Legacy fields from earlier versions of this actor keep their original names and formats; richer numeric and structured companions sit beside them.\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `recordType` | String | `item`, or `store` / `storeCategory` for an empty-source summary |\n| `id`, `itemId` | String | eBay item ID |\n| `url` | String | Canonical item URL |\n| `title` | String | Listing title |\n| `price` | String | Historical price format, e.g. `US $339.99` |\n| `priceValue`, `priceCurrency` | Number, String | Numeric price and ISO currency |\n| `originalPrice`, `wasPrice`, `wasPriceValue`, `discountPercent` | Mixed | Comparison price when discounted |\n| `condition`, `conditionDescription` | String | Condition label and its longer explanation |\n| `brand`, `model`, `mpn`, `gtin`, `color` | String | Product identifiers |\n| `seller`, `sellerFeedbackScore`, `sellerFeedbackPercent`, `sellerFeedbackCount` | Mixed | Seller identity and trust |\n| `sellerUrl`, `sellerStoreUrl` | String | Seller store link |\n| `availableQuantity`, `quantityAvailable` | String, Number | Stock |\n| `soldCount`, `quantitySold` | String, Number | Units sold |\n| `watchCount`, `watcherCount` | String, Number | Watchers |\n| `location`, `itemLocation` | String | Item location |\n| `shippingCost`, `shippingCostValue`, `shippingCurrency`, `shippingDestination` | Mixed | Shipping terms |\n| `returnPolicy`, `returns`, `returnDays`, `returnFees` | Mixed | Return terms |\n| `paymentMethods` | Array | Accepted payment methods |\n| `listingStartDate`, `startTime` | String | ISO 8601 listing start |\n| `images`, `imageUrl` | Array, String | Full-size gallery |\n| `itemSpecifics`, `sellerNotes` | Object, String | Complete specifics table |\n| `categories`, `categoryPath` | Array | Breadcrumb path |\n| `authenticityGuarantee`, `topRatedSeller`, `businessSeller` | Boolean | Trust badges |\n| `listingType`, `bids`, `bidCount`, `timeLeft` | Mixed | Sale format and auction data |\n| `vehicle` | Object | VIN, mileage and other eBay Motors fields (only on vehicle listings) |\n| `marketplace` | String | Marketplace code |\n| `searchUrl`, `storeListingUrl` | String | Page that produced the record |\n| `storeName`, `storeUrl`, `storeTagline`, `storeFeedbackPercent`, `storeItemsSold`, `storeFollowers`, `storeListingCount` | Mixed | Store context attached to store-mode records |\n| `storeCategoryName`, `storeCategoryUrl`, `storeCategoryId` | String | Category context attached to store-category records |\n| `scrapedAt` | String | ISO 8601 scrape time |\n\n### Example output\n\n```json\n{\n \"recordType\": \"item\",\n \"id\": \"257633093777\",\n \"itemId\": \"257633093777\",\n \"url\": \"https://www.ebay.com/itm/257633093777\",\n \"title\": \"Lenovo ThinkBook 15-ITL 15.6\\\" Core i5 16GB RAM 256GB SSD Windows 11 Pro Laptop\",\n \"price\": \"US $339.99\",\n \"priceValue\": 339.99,\n \"priceCurrency\": \"USD\",\n \"condition\": \"Good - Refurbished\",\n \"brand\": \"Lenovo\",\n \"model\": \"Lenovo ThinkBook 15 ITL\",\n \"mpn\": \"lenovodeals\",\n \"color\": \"Gray\",\n \"seller\": \"Discount Computer Depot\",\n \"sellerFeedbackScore\": \"178796\",\n \"sellerFeedbackCount\": 178796,\n \"sellerFeedbackPercent\": \"99.6%\",\n \"sellerUrl\": \"https://www.ebay.com/str/discountcomputerdepot\",\n \"availableQuantity\": \"10\",\n \"quantityAvailable\": 10,\n \"soldCount\": \"29\",\n \"quantitySold\": 29,\n \"watchCount\": \"183\",\n \"watcherCount\": 183,\n \"location\": \"Jacksonville, Texas, United States\",\n \"shippingCost\": \"Free shipping\",\n \"returnPolicy\": \"30 days returns\",\n \"returnDays\": 30,\n \"paymentMethods\": [\"PayPal\", \"Visa\", \"Master Card\"],\n \"listingStartDate\": \"2026-07-20T20:20:59Z\",\n \"images\": [\"https://i.ebayimg.com/images/g/example/s-l1600.jpg\"],\n \"itemSpecifics\": {\"Brand\": \"Lenovo\", \"Processor\": \"Intel Core i5-1135G7\"},\n \"categories\": [\"eBay\", \"Electronics\", \"Computers/Tablets & Networking\"],\n \"authenticityGuarantee\": false,\n \"topRatedSeller\": true,\n \"businessSeller\": false,\n \"listingType\": \"Buy It Now\",\n \"marketplace\": \"US\",\n \"scrapedAt\": \"2026-11-09T10:00:00+00:00\"\n}\n```\n\n## How pagination works\n\n- Search and store listing pages accept 60, 120 or 240 rows per page; the actor right-sizes the page to the remaining `maxItems`.\n- `maxPages` caps pages per store, category or search source. When you need more than 240 x 200 rows for one query, split by category or price range.\n- Pagination stops on `maxItems`, the last page, a page with no new item IDs, or a repeated page.\n\n## Tips for reliable runs\n\n1. For a handful of listings, use **Item details** with item IDs.\n2. For a seller's catalogue, use **Store inventory** and set `maxPages` high enough for the store size.\n3. To split a large store, copy category links from the store page into **Store category**.\n4. Keep `includeItemDetails` on when you need specifics, images and return terms; turn it off when card-level title/price is enough.\n5. `maxItems` is shared by all sources, so size it for the total you want.\n\n## FAQ\n\n### Do I need cookies, an account or a proxy?\n\nNo. The actor reads public pages and selects its network path automatically. There is no proxy field to configure and no credential to paste.\n\n### Why are some fields missing on a record?\n\neBay only renders some data for some listings: `originalPrice` appears when discounted, `bids` only on auctions, `vehicle` only on Motors listings, and `returnPolicy` may be absent on as-is vehicle listings. Missing values are omitted rather than emitted as null.\n\n### Can I use UK, German or Australian eBay?\n\nYes. Pick the marketplace site for names and keywords, or paste URLs from any of the eight supported country sites. A pasted URL keeps its own domain.\n\n### Does it support sold or completed listings?\n\nNo. eBay puts sold/completed search behind a sign-in wall, and this actor deliberately never uses cookies or logins. Active listings only.\n\n### Can I get the full store inventory?\n\nYes, until the store's own pagination ends or `maxItems` is reached. Use `maxPages` to control how deep it walks.\n\n### What is the difference between Store inventory and Store category?\n\nStore inventory walks the whole store. Store category walks one category inside the store; use it to partition very large stores into smaller runs.\n\n## Limitations\n\n- Sold and completed listings require an eBay sign-in, so they are out of scope.\n- eBay caps a single result set at 200 pages; split large sweeps by category or price band.\n- A few card fields (rating, watchers, sold count) are only shown by eBay on some listings; they are omitted when absent.\n- eBay changes its markup from time to time. The actor supports both the current item-detail schema and the localized marketplace variants it has been verified against.\n", "actorDefinition": { "actorSpecification": 1, "name": "ebay-item-store-and-store-category-detail", "title": "eBay Item, Store & Store Category Detail Extractor", "description": "Open eBay item pages and walk store or store-category inventories with pagination to collect full item specifics, images, seller trust signals, shipping and return terms across eight marketplaces.", "version": "1.0", "minMemoryMbytes": 1024, "defaultRunOptions": { "build": "latest", "timeoutSecs": 1800, "memoryMbytes": 1024 }, "input": { "title": "eBay Item, Store & Store Category Detail Input", "description": "Choose what to scrape — item pages, a seller store inventory, one store category, or keyword search — then set marketplace and result limits.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "What to scrape", "type": "string", "description": "Item details opens the item pages you list. Store inventory walks a seller's whole store. Store category walks one category inside a store. Keyword search finds matching listings.", "editor": "select", "enum": [ "item", "store", "storeCategory", "search" ], "enumTitles": [ "Item details — open specific item pages", "Store inventory — every active listing in a seller store", "Store category — one category inside a seller store", "Keyword search — listings matching your terms" ], "default": "search", "prefill": "search", "sectionCaption": "Mode" }, "itemIds": { "title": "Item IDs or URLs", "type": "array", "description": "eBay item IDs (for example 257633093777) or full /itm/ links. Used in Item details mode.", "editor": "stringList", "default": [] }, "storeNames": { "title": "Store names or URLs", "type": "array", "description": "Seller store names (for example discountcomputerdepot) or /str/ store links. Used in Store inventory mode.", "editor": "stringList", "default": [] }, "storeCategoryUrls": { "title": "Store category URLs", "type": "array", "description": "Store-category links copied from a store page, for example https://www.ebay.com/str/mystore/Laptops/_i.html?store_cat=1234567890. Used in Store category mode.", "editor": "stringList", "default": [] }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search on the selected marketplace. One search per entry. Used in Keyword search mode.", "editor": "stringList", "default": [], "prefill": [ "laptop" ] }, "startUrls": { "title": "Paste any eBay URLs (optional shortcut)", "type": "array", "description": "Paste item, store, store-category, category-browse or search links and each is routed to the right mode automatically. Ignored when the arrays above already cover that source.", "editor": "requestListSources", "default": [] }, "marketplace": { "title": "Marketplace", "type": "string", "description": "Country site used for names and keywords, and for any input that is not already a full URL. The dropdown carries the legacy full-URL values; short codes (US, GB, DE, FR, IT, ES, CA, AU) are also accepted by API callers.", "editor": "select", "enum": [ "https://www.ebay.com", "https://www.ebay.co.uk", "https://www.ebay.de", "https://www.ebay.fr", "https://www.ebay.it", "https://www.ebay.es", "https://www.ebay.ca", "https://www.ebay.com.au" ], "enumTitles": [ "United States (ebay.com)", "United Kingdom (ebay.co.uk)", "Germany (ebay.de)", "France (ebay.fr)", "Italy (ebay.it)", "Spain (ebay.es)", "Canada (ebay.ca)", "Australia (ebay.com.au)" ], "default": "https://www.ebay.com", "prefill": "https://www.ebay.com", "sectionCaption": "Marketplace & filters" }, "condition": { "title": "Item condition", "type": "string", "description": "Filter keyword-search results by condition. Leave on All conditions for every condition.", "editor": "select", "enum": [ "", "new", "openBox", "manufacturerRefurbished", "refurbished", "used", "forParts" ], "enumTitles": [ "All conditions", "New", "Open box", "Manufacturer refurbished", "Seller refurbished", "Used", "For parts or not working" ], "default": "" }, "buyingFormat": { "title": "Buying format", "type": "string", "description": "Show only Buy It Now or auction listings in keyword-search results.", "editor": "select", "enum": [ "", "buyItNow", "auction" ], "enumTitles": [ "Buy It Now & auctions", "Buy It Now only", "Auctions only" ], "default": "" }, "minPrice": { "title": "Minimum price", "type": "number", "description": "Filter keyword-search results by minimum item price in the marketplace's local currency.", "editor": "number", "minimum": 0, "maximum": 1000000000 }, "maxPrice": { "title": "Maximum price", "type": "number", "description": "Filter keyword-search results by maximum item price in the marketplace's local currency.", "editor": "number", "minimum": 0, "maximum": 1000000000 }, "sortBy": { "title": "Sort order", "type": "string", "description": "How to order keyword-search results.", "editor": "select", "enum": [ "bestMatch", "priceLowest", "priceHighest", "endingSoonest", "newlyListed" ], "enumTitles": [ "Best match", "Price: lowest first", "Price: highest first", "Ending soonest", "Newly listed" ], "default": "bestMatch" }, "freeShipping": { "title": "Free shipping only", "type": "boolean", "description": "Keep only keyword-search results that advertise free shipping or delivery.", "default": false, "prefill": false }, "returnsAccepted": { "title": "Returns accepted only", "type": "boolean", "description": "Keep only keyword-search results that accept returns.", "default": false, "prefill": false }, "itemLocation": { "title": "Item location", "type": "string", "description": "Keep keyword-search results located in the marketplace country, or show worldwide results.", "editor": "select", "enum": [ "", "domestic", "worldwide" ], "enumTitles": [ "Any location", "Domestic only", "Worldwide" ], "default": "" }, "maxItems": { "title": "Max records", "type": "integer", "description": "Upper limit on item records across every source.", "default": 3, "prefill": 2, "minimum": 1, "maximum": 10000, "sectionCaption": "Result limits" }, "maxPages": { "title": "Max pages per source", "type": "integer", "description": "Stop after this many listing pages per store, category or search. Each page holds up to 240 listings.", "default": 10, "prefill": 1, "minimum": 1, "maximum": 200 }, "includeItemDetails": { "title": "Open each listing for full item details", "type": "boolean", "description": "When on, every discovered listing is opened and returns the full item record (specifics, images, seller, shipping, returns). Turn off for a faster card-level result from search and store pages.", "default": true, "prefill": true }, "includeItemSpecifics": { "title": "Include the item-specifics table", "type": "boolean", "description": "Add the full item-specifics table (brand, model, MPN, dimensions, features and other aspects) to item records.", "default": true, "prefill": true } } }, "output": { "actorOutputSchemaVersion": 1, "title": "eBay Item, Store & Store Category Detail Output", "description": "Item-detail records from eBay item pages plus store and store-category inventory walks, including specifics, images, seller trust signals, shipping and returns.", "type": "object", "properties": { "items": { "type": "string", "title": "eBay Product Details", "description": "Dataset containing detailed eBay item, store and store-category records.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "dockerfile": "../Dockerfile", "readme": "# eBay Item, Store & Store Category Detail Extractor\n\nOpen eBay item pages, walk a seller's entire store, or crawl one store category, and get complete item-detail records: item specifics, every high-resolution image, seller and store trust signals, stock and sales counts, shipping terms and return policy.\n\nThe actor reads public eBay pages only. No cookie, login, API key or proxy setup is required — paste a URL or a name and run.\n\n## What can it scrape?\n\n| Mode | Start with | What you get |\n|------|-----------|--------------|\n| **Item details** | Item IDs or `/itm/` links | One full record per listing |\n| **Store inventory** | Store names or `/str/` links | The store's active listings, paginated, each opened for full details |\n| **Store category** | Store-category links | One category inside a store, paginated, each listing opened for full details |\n| **Keyword search** | Plain keywords | Matching listings, paginated, each opened for full details |\n\nAll four modes share one result budget (`maxItems`) and one page budget per source (`maxPages`). Discovery is paginated automatically: search pages, store fronts and store categories are walked until the budget is reached, the source runs out of pages, or a page returns no new item IDs.\n\n## Input\n\n| Field | Type | Default | Description |\n|-------|------|---------|-------------|\n| `mode` | Select | `search` | Item details, Store inventory, Store category, or Keyword search |\n| `itemIds` | Array | – | Item IDs (`257633093777`) or full `/itm/` links |\n| `storeNames` | Array | – | Store names (`discountcomputerdepot`) or `/str/` links |\n| `storeCategoryUrls` | Array | – | Store-category links such as `https://www.ebay.com/str/mystore/Laptops/_i.html?store_cat=1234567890` |\n| `searchQueries` | Array | – | Keywords, one search per entry |\n| `startUrls` | Array | – | Optional shortcut: paste any eBay URL and it is routed to the right mode |\n| `marketplace` | Select | `https://www.ebay.com` | One of 8 country sites (US, UK, DE, FR, IT, ES, CA, AU). The dropdown keeps the legacy full-URL values; API callers may also send `US`, `GB`, etc. |\n| `condition` | Select | All | New, Open box, Manufacturer refurbished, Seller refurbished, Used, For parts |\n| `buyingFormat` | Select | `\"\"` | Buy It Now only or Auctions only |\n| `minPrice` / `maxPrice` | Number | – | Price range in the marketplace currency |\n| `sortBy` | Select | `bestMatch` | Best match, price low/high, ending soonest, newly listed |\n| `freeShipping` | Boolean | `false` | Keep only free-shipping listings |\n| `returnsAccepted` | Boolean | `false` | Keep only listings that accept returns |\n| `itemLocation` | Select | Any | Domestic-only or worldwide |\n| `maxItems` | Integer | `3` | Total records across every source |\n| `maxPages` | Integer | `10` | Listing pages per store, category or search (up to 240 listings each) |\n| `includeItemDetails` | Boolean | `true` | Open each discovered listing for the full item record; turn off for faster card-level results |\n| `includeItemSpecifics` | Boolean | `true` | Include the item-specifics table and seller notes |\n\nCondition, buying-format, price, sort, shipping, returns and item-location filters apply to **Keyword search** results. Store and Store category modes walk the seller's inventory in its own order.\n\n### Supported URL shapes\n\n- Item: `https://www.ebay.com/itm/267153498498`\n- Item with slug: `https://www.ebay.com/itm/Product-Title-Here/267153498498`\n- Store: `https://www.ebay.com/str/thriftbooks`\n- Store category: `https://www.ebay.com/str/thriftbooks/Fiction/_i.html?store_cat=261186`\n- Search: `https://www.ebay.co.uk/sch/i.html?_nkw=laptop`\n- Category browse: `https://www.ebay.com/b/PC-Laptops-Netbooks/177`\n\n### Example: item details\n\n```json\n{\n \"mode\": \"item\",\n \"itemIds\": [\"257633093777\"],\n \"maxItems\": 1\n}\n```\n\n### Example: store category\n\n```json\n{\n \"mode\": \"storeCategory\",\n \"storeCategoryUrls\": [\n \"https://www.ebay.com/str/discountcomputerdepot/Laptops/_i.html?store_cat=10748275017\"\n ],\n \"maxItems\": 20,\n \"maxPages\": 2\n}\n```\n\n### Example: keyword search\n\n```json\n{\n \"mode\": \"search\",\n \"searchQueries\": [\"iphone 15 pro\", \"pixel 9\"],\n \"marketplace\": \"https://www.ebay.co.uk\",\n \"condition\": \"used\",\n \"maxItems\": 50,\n \"maxPages\": 3\n}\n```\n\n## Output\n\nEvery record is an item-detail record when `includeItemDetails` is on. Legacy fields from earlier versions of this actor keep their original names and formats; richer numeric and structured companions sit beside them.\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `recordType` | String | `item`, or `store` / `storeCategory` for an empty-source summary |\n| `id`, `itemId` | String | eBay item ID |\n| `url` | String | Canonical item URL |\n| `title` | String | Listing title |\n| `price` | String | Historical price format, e.g. `US $339.99` |\n| `priceValue`, `priceCurrency` | Number, String | Numeric price and ISO currency |\n| `originalPrice`, `wasPrice`, `wasPriceValue`, `discountPercent` | Mixed | Comparison price when discounted |\n| `condition`, `conditionDescription` | String | Condition label and its longer explanation |\n| `brand`, `model`, `mpn`, `gtin`, `color` | String | Product identifiers |\n| `seller`, `sellerFeedbackScore`, `sellerFeedbackPercent`, `sellerFeedbackCount` | Mixed | Seller identity and trust |\n| `sellerUrl`, `sellerStoreUrl` | String | Seller store link |\n| `availableQuantity`, `quantityAvailable` | String, Number | Stock |\n| `soldCount`, `quantitySold` | String, Number | Units sold |\n| `watchCount`, `watcherCount` | String, Number | Watchers |\n| `location`, `itemLocation` | String | Item location |\n| `shippingCost`, `shippingCostValue`, `shippingCurrency`, `shippingDestination` | Mixed | Shipping terms |\n| `returnPolicy`, `returns`, `returnDays`, `returnFees` | Mixed | Return terms |\n| `paymentMethods` | Array | Accepted payment methods |\n| `listingStartDate`, `startTime` | String | ISO 8601 listing start |\n| `images`, `imageUrl` | Array, String | Full-size gallery |\n| `itemSpecifics`, `sellerNotes` | Object, String | Complete specifics table |\n| `categories`, `categoryPath` | Array | Breadcrumb path |\n| `authenticityGuarantee`, `topRatedSeller`, `businessSeller` | Boolean | Trust badges |\n| `listingType`, `bids`, `bidCount`, `timeLeft` | Mixed | Sale format and auction data |\n| `vehicle` | Object | VIN, mileage and other eBay Motors fields (only on vehicle listings) |\n| `marketplace` | String | Marketplace code |\n| `searchUrl`, `storeListingUrl` | String | Page that produced the record |\n| `storeName`, `storeUrl`, `storeTagline`, `storeFeedbackPercent`, `storeItemsSold`, `storeFollowers`, `storeListingCount` | Mixed | Store context attached to store-mode records |\n| `storeCategoryName`, `storeCategoryUrl`, `storeCategoryId` | String | Category context attached to store-category records |\n| `scrapedAt` | String | ISO 8601 scrape time |\n\n### Example output\n\n```json\n{\n \"recordType\": \"item\",\n \"id\": \"257633093777\",\n \"itemId\": \"257633093777\",\n \"url\": \"https://www.ebay.com/itm/257633093777\",\n \"title\": \"Lenovo ThinkBook 15-ITL 15.6\\\" Core i5 16GB RAM 256GB SSD Windows 11 Pro Laptop\",\n \"price\": \"US $339.99\",\n \"priceValue\": 339.99,\n \"priceCurrency\": \"USD\",\n \"condition\": \"Good - Refurbished\",\n \"brand\": \"Lenovo\",\n \"model\": \"Lenovo ThinkBook 15 ITL\",\n \"mpn\": \"lenovodeals\",\n \"color\": \"Gray\",\n \"seller\": \"Discount Computer Depot\",\n \"sellerFeedbackScore\": \"178796\",\n \"sellerFeedbackCount\": 178796,\n \"sellerFeedbackPercent\": \"99.6%\",\n \"sellerUrl\": \"https://www.ebay.com/str/discountcomputerdepot\",\n \"availableQuantity\": \"10\",\n \"quantityAvailable\": 10,\n \"soldCount\": \"29\",\n \"quantitySold\": 29,\n \"watchCount\": \"183\",\n \"watcherCount\": 183,\n \"location\": \"Jacksonville, Texas, United States\",\n \"shippingCost\": \"Free shipping\",\n \"returnPolicy\": \"30 days returns\",\n \"returnDays\": 30,\n \"paymentMethods\": [\"PayPal\", \"Visa\", \"Master Card\"],\n \"listingStartDate\": \"2026-07-20T20:20:59Z\",\n \"images\": [\"https://i.ebayimg.com/images/g/example/s-l1600.jpg\"],\n \"itemSpecifics\": {\"Brand\": \"Lenovo\", \"Processor\": \"Intel Core i5-1135G7\"},\n \"categories\": [\"eBay\", \"Electronics\", \"Computers/Tablets & Networking\"],\n \"authenticityGuarantee\": false,\n \"topRatedSeller\": true,\n \"businessSeller\": false,\n \"listingType\": \"Buy It Now\",\n \"marketplace\": \"US\",\n \"scrapedAt\": \"2026-11-09T10:00:00+00:00\"\n}\n```\n\n## How pagination works\n\n- Search and store listing pages accept 60, 120 or 240 rows per page; the actor right-sizes the page to the remaining `maxItems`.\n- `maxPages` caps pages per store, category or search source. When you need more than 240 x 200 rows for one query, split by category or price range.\n- Pagination stops on `maxItems`, the last page, a page with no new item IDs, or a repeated page.\n\n## Tips for reliable runs\n\n1. For a handful of listings, use **Item details** with item IDs.\n2. For a seller's catalogue, use **Store inventory** and set `maxPages` high enough for the store size.\n3. To split a large store, copy category links from the store page into **Store category**.\n4. Keep `includeItemDetails` on when you need specifics, images and return terms; turn it off when card-level title/price is enough.\n5. `maxItems` is shared by all sources, so size it for the total you want.\n\n## FAQ\n\n### Do I need cookies, an account or a proxy?\n\nNo. The actor reads public pages and selects its network path automatically. There is no proxy field to configure and no credential to paste.\n\n### Why are some fields missing on a record?\n\neBay only renders some data for some listings: `originalPrice` appears when discounted, `bids` only on auctions, `vehicle` only on Motors listings, and `returnPolicy` may be absent on as-is vehicle listings. Missing values are omitted rather than emitted as null.\n\n### Can I use UK, German or Australian eBay?\n\nYes. Pick the marketplace site for names and keywords, or paste URLs from any of the eight supported country sites. A pasted URL keeps its own domain.\n\n### Does it support sold or completed listings?\n\nNo. eBay puts sold/completed search behind a sign-in wall, and this actor deliberately never uses cookies or logins. Active listings only.\n\n### Can I get the full store inventory?\n\nYes, until the store's own pagination ends or `maxItems` is reached. Use `maxPages` to control how deep it walks.\n\n### What is the difference between Store inventory and Store category?\n\nStore inventory walks the whole store. Store category walks one category inside the store; use it to partition very large stores into smaller runs.\n\n## Limitations\n\n- Sold and completed listings require an eBay sign-in, so they are out of scope.\n- eBay caps a single result set at 200 pages; split large sweeps by category or price band.\n- A few card fields (rating, watchers, sold count) are only shown by eBay on some listings; they are omitted when absent.\n- eBay changes its markup from time to time. The actor supports both the current item-detail schema and the localized marketplace variants it has been verified against.\n", "storages": { "dataset": { "actorSpecification": 1, "title": "eBay Item, Store & Store Category Details", "fields": { "type": "object", "properties": { "recordType": { "type": "string", "description": "Record kind: item, store (empty store fallback) or storeCategory (empty category fallback)" }, "url": { "type": "string", "description": "Direct URL to the eBay item listing" }, "id": { "type": "string", "description": "eBay item ID number" }, "itemId": { "type": "string", "description": "eBay item ID number (numeric companion to id)" }, "title": { "type": "string", "description": "Full product title" }, "price": { "type": "string", "description": "Current price in this actor's historical format (for example 'US $384.92')" }, "priceValue": { "type": "number", "description": "Numeric current price" }, "priceCurrency": { "type": "string", "description": "ISO currency code for priceValue" }, "originalPrice": { "type": "string", "nullable": true, "description": "Original price before discount, omitted when not discounted" }, "wasPrice": { "type": "string", "nullable": true, "description": "Struck-through comparison price as shown on the page" }, "wasPriceValue": { "type": "number", "nullable": true, "description": "Numeric comparison price" }, "discountPercent": { "type": "number", "nullable": true, "description": "Discount percentage when a comparison price is shown" }, "condition": { "type": "string", "description": "Item condition: New, Used, Refurbished, For parts or not working, etc." }, "conditionDescription": { "type": "string", "nullable": true, "description": "Longer condition explanation shown on the listing" }, "brand": { "type": "string", "nullable": true, "description": "Product brand" }, "model": { "type": "string", "nullable": true, "description": "Product model" }, "mpn": { "type": "string", "nullable": true, "description": "Manufacturer part number" }, "gtin": { "type": "string", "nullable": true, "description": "GTIN, EAN, UPC or ISBN when present" }, "color": { "type": "string", "nullable": true, "description": "Item colour" }, "availability": { "type": "string", "nullable": true, "description": "Stock availability text" }, "seller": { "type": "string", "description": "Seller display name" }, "sellerFeedbackScore": { "type": "string", "description": "Seller total feedback count as text (historical field)" }, "sellerFeedbackCount": { "type": "number", "nullable": true, "description": "Seller total feedback count as a number" }, "sellerFeedbackPercent": { "type": "string", "nullable": true, "description": "Seller positive feedback percentage" }, "sellerUrl": { "type": "string", "nullable": true, "description": "URL to the seller's eBay store" }, "sellerStoreUrl": { "type": "string", "nullable": true, "description": "URL to the seller's eBay store" }, "sellerNotes": { "type": "string", "nullable": true, "description": "Seller's condition notes" }, "availableQuantity": { "type": "string", "nullable": true, "description": "Number of items in stock as text (historical field)" }, "quantityAvailable": { "type": "number", "nullable": true, "description": "Number of items in stock as a number" }, "soldCount": { "type": "string", "nullable": true, "description": "Number of units sold as text (historical field)" }, "quantitySold": { "type": "number", "nullable": true, "description": "Number of units sold as a number" }, "watchCount": { "type": "string", "nullable": true, "description": "Number of watchers as text (historical field)" }, "watcherCount": { "type": "number", "nullable": true, "description": "Number of watchers as a number" }, "location": { "type": "string", "nullable": true, "description": "Item geographic location (historical field)" }, "itemLocation": { "type": "string", "nullable": true, "description": "Item geographic location" }, "shippingCost": { "type": "string", "nullable": true, "description": "Shipping cost text or 'Free shipping'" }, "shippingCostValue": { "type": "number", "nullable": true, "description": "Numeric shipping cost" }, "shippingCurrency": { "type": "string", "nullable": true, "description": "ISO currency code for shippingCostValue" }, "shippingDestination": { "type": "string", "nullable": true, "description": "Destination country the shipping quote applies to" }, "returnPolicy": { "type": "string", "nullable": true, "description": "Return policy text (historical field)" }, "returns": { "type": "string", "nullable": true, "description": "Return policy text" }, "returnDays": { "type": "number", "nullable": true, "description": "Return window in days" }, "returnFees": { "type": "string", "nullable": true, "description": "Who pays return shipping" }, "paymentMethods": { "type": "array", "description": "Accepted payment methods" }, "listingStartDate": { "type": "string", "nullable": true, "description": "ISO 8601 listing start timestamp (historical field)" }, "startTime": { "type": "string", "nullable": true, "description": "ISO 8601 listing start timestamp" }, "images": { "type": "array", "description": "All high-resolution product image URLs" }, "imageUrl": { "type": "string", "nullable": true, "description": "Primary product image URL" }, "itemSpecifics": { "type": "object", "description": "Key-value pairs of item specifics" }, "categories": { "type": "array", "description": "Breadcrumb category path (historical field)" }, "categoryPath": { "type": "array", "description": "Breadcrumb category path" }, "authenticityGuarantee": { "type": "boolean", "description": "Whether the listing shows eBay's Authenticity Guarantee" }, "topRatedSeller": { "type": "boolean", "description": "Whether the seller shows the Top Rated badge" }, "businessSeller": { "type": "boolean", "description": "Whether the seller is registered as a business seller" }, "listingType": { "type": "string", "description": "Buy It Now, Auction, or Buy It Now or Best Offer" }, "bids": { "type": "string", "nullable": true, "description": "Number of bids as text (historical field)" }, "bidCount": { "type": "number", "nullable": true, "description": "Number of bids" }, "timeLeft": { "type": "string", "nullable": true, "description": "Auction time remaining" }, "vehicle": { "type": "object", "description": "Vehicle fields for eBay Motors listings; absent for all other listings" }, "marketplace": { "type": "string", "description": "Marketplace code used for the record" }, "searchUrl": { "type": "string", "nullable": true, "description": "Search URL that produced this record" }, "storeName": { "type": "string", "nullable": true, "description": "Seller store display name" }, "storeUrl": { "type": "string", "nullable": true, "description": "Seller store URL" }, "storeTagline": { "type": "string", "nullable": true, "description": "Store tagline or description" }, "storeFeedbackPercent": { "type": "string", "nullable": true, "description": "Store positive feedback percentage" }, "storeItemsSold": { "type": "number", "nullable": true, "description": "Items the store has sold" }, "storeFollowers": { "type": "number", "nullable": true, "description": "Store followers" }, "storeListingCount": { "type": "string", "nullable": true, "description": "Store listing count label" }, "storeListingUrl": { "type": "string", "nullable": true, "description": "Store listing page that produced this record" }, "storeCategoryName": { "type": "string", "nullable": true, "description": "Store category display name" }, "storeCategoryUrl": { "type": "string", "nullable": true, "description": "Store category URL" }, "storeCategoryId": { "type": "string", "nullable": true, "description": "eBay store category ID" }, "scrapedAt": { "type": "string", "description": "ISO 8601 timestamp when the record was scraped" } } }, "views": { "overview": { "title": "Overview", "transformation": { "fields": [ "recordType", "title", "price", "condition", "seller", "storeName", "storeCategoryName", "url" ] }, "display": { "component": "table", "properties": { "recordType": { "label": "Type", "format": "text" }, "title": { "label": "Title", "format": "text" }, "price": { "label": "Price", "format": "text" }, "condition": { "label": "Condition", "format": "text" }, "seller": { "label": "Seller", "format": "text" }, "storeName": { "label": "Store", "format": "text" }, "storeCategoryName": { "label": "Store Category", "format": "text" }, "url": { "label": "URL", "format": "link" } } } }, "details": { "title": "Item Details", "transformation": { "fields": [ "title", "price", "priceValue", "priceCurrency", "originalPrice", "condition", "brand", "model", "mpn", "seller", "sellerFeedbackScore", "sellerFeedbackPercent", "quantityAvailable", "quantitySold", "watchCount", "shippingCost", "returnPolicy", "listingStartDate", "listingType", "bids", "url" ] }, "display": { "component": "table", "properties": { "title": { "label": "Title", "format": "text" }, "price": { "label": "Price", "format": "text" }, "priceValue": { "label": "Price Value", "format": "number" }, "priceCurrency": { "label": "Currency", "format": "text" }, "originalPrice": { "label": "Was", "format": "text" }, "condition": { "label": "Condition", "format": "text" }, "brand": { "label": "Brand", "format": "text" }, "model": { "label": "Model", "format": "text" }, "mpn": { "label": "MPN", "format": "text" }, "seller": { "label": "Seller", "format": "text" }, "sellerFeedbackScore": { "label": "Feedback", "format": "text" }, "sellerFeedbackPercent": { "label": "Positive %", "format": "text" }, "quantityAvailable": { "label": "Stock", "format": "number" }, "quantitySold": { "label": "Sold", "format": "number" }, "watchCount": { "label": "Watching", "format": "text" }, "shippingCost": { "label": "Shipping", "format": "text" }, "returnPolicy": { "label": "Returns", "format": "text" }, "listingStartDate": { "label": "Listed", "format": "date" }, "listingType": { "label": "Type", "format": "text" }, "bids": { "label": "Bids", "format": "text" }, "url": { "label": "URL", "format": "link" } } } }, "storeProfiles": { "title": "Store & Category Records", "transformation": { "fields": [ "recordType", "storeName", "storeUrl", "storeTagline", "storeFeedbackPercent", "storeItemsSold", "storeFollowers", "storeListingCount", "storeCategoryName", "storeCategoryUrl", "storeCategoryId" ] }, "display": { "component": "table", "properties": { "recordType": { "label": "Type", "format": "text" }, "storeName": { "label": "Store", "format": "text" }, "storeUrl": { "label": "Store URL", "format": "link" }, "storeTagline": { "label": "Tagline", "format": "text" }, "storeFeedbackPercent": { "label": "Positive %", "format": "text" }, "storeItemsSold": { "label": "Items Sold", "format": "number" }, "storeFollowers": { "label": "Followers", "format": "number" }, "storeListingCount": { "label": "Listings", "format": "text" }, "storeCategoryName": { "label": "Category", "format": "text" }, "storeCategoryUrl": { "label": "Category URL", "format": "link" }, "storeCategoryId": { "label": "Category ID", "format": "text" } } } } } } } }, "buildNumber": "1.0.2", "imageDigest": "01d226647ef3441b60da27871eb16abb54b4c3eda396f327016d214b231bb0ed", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.010752222222222222 } } }