eBay Item, Store & Store Category Detail Extractor

Open 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.

The actor reads public eBay pages only. No cookie, login, API key or proxy setup is required — paste a URL or a name and run.

What can it scrape?

Mode	Start with	What you get
Item details	Item IDs or /itm/ links	One full record per listing
Store inventory	Store names or /str/ links	The store's active listings, paginated, each opened for full details
Store category	Store-category links	One category inside a store, paginated, each listing opened for full details
Keyword search	Plain keywords	Matching listings, paginated, each opened for full details

All 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.

Input

Field	Type	Default	Description
mode	Select	search	Item details, Store inventory, Store category, or Keyword search
itemIds	Array	–	Item IDs (257633093777) or full /itm/ links
storeNames	Array	–	Store names (discountcomputerdepot) or /str/ links
storeCategoryUrls	Array	–	Store-category links such as https://www.ebay.com/str/mystore/Laptops/_i.html?store_cat=1234567890
searchQueries	Array	–	Keywords, one search per entry
startUrls	Array	–	Optional shortcut: paste any eBay URL and it is routed to the right mode
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.
condition	Select	All	New, Open box, Manufacturer refurbished, Seller refurbished, Used, For parts
buyingFormat	Select	""	Buy It Now only or Auctions only
minPrice / maxPrice	Number	–	Price range in the marketplace currency
sortBy	Select	bestMatch	Best match, price low/high, ending soonest, newly listed
freeShipping	Boolean	false	Keep only free-shipping listings
returnsAccepted	Boolean	false	Keep only listings that accept returns
itemLocation	Select	Any	Domestic-only or worldwide
maxItems	Integer	3	Total records across every source
maxPages	Integer	10	Listing pages per store, category or search (up to 240 listings each)
includeItemDetails	Boolean	true	Open each discovered listing for the full item record; turn off for faster card-level results
includeItemSpecifics	Boolean	true	Include the item-specifics table and seller notes

Condition, 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.

Supported URL shapes

• Item: https://www.ebay.com/itm/267153498498
• Item with slug: https://www.ebay.com/itm/Product-Title-Here/267153498498
• Store: https://www.ebay.com/str/thriftbooks
• Store category: https://www.ebay.com/str/thriftbooks/Fiction/_i.html?store_cat=261186
• Search: https://www.ebay.co.uk/sch/i.html?_nkw=laptop
• Category browse: https://www.ebay.com/b/PC-Laptops-Netbooks/177

Example: item details

{
    "mode": "item",
    "itemIds": ["257633093777"],
    "maxItems": 1
}

Example: store category

{
    "mode": "storeCategory",
    "storeCategoryUrls": [
        "https://www.ebay.com/str/discountcomputerdepot/Laptops/_i.html?store_cat=10748275017"
    ],
    "maxItems": 20,
    "maxPages": 2
}

Example: keyword search

{
    "mode": "search",
    "searchQueries": ["iphone 15 pro", "pixel 9"],
    "marketplace": "https://www.ebay.co.uk",
    "condition": "used",
    "maxItems": 50,
    "maxPages": 3
}

Output

Every 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.

Field	Type	Description
recordType	String	item, or store / storeCategory for an empty-source summary
id, itemId	String	eBay item ID
url	String	Canonical item URL
title	String	Listing title
price	String	Historical price format, e.g. US $339.99
priceValue, priceCurrency	Number, String	Numeric price and ISO currency
originalPrice, wasPrice, wasPriceValue, discountPercent	Mixed	Comparison price when discounted
condition, conditionDescription	String	Condition label and its longer explanation
brand, model, mpn, gtin, color	String	Product identifiers
seller, sellerFeedbackScore, sellerFeedbackPercent, sellerFeedbackCount	Mixed	Seller identity and trust
sellerUrl, sellerStoreUrl	String	Seller store link
availableQuantity, quantityAvailable	String, Number	Stock
soldCount, quantitySold	String, Number	Units sold
watchCount, watcherCount	String, Number	Watchers
location, itemLocation	String	Item location
shippingCost, shippingCostValue, shippingCurrency, shippingDestination	Mixed	Shipping terms
returnPolicy, returns, returnDays, returnFees	Mixed	Return terms
paymentMethods	Array	Accepted payment methods
listingStartDate, startTime	String	ISO 8601 listing start
images, imageUrl	Array, String	Full-size gallery
itemSpecifics, sellerNotes	Object, String	Complete specifics table
categories, categoryPath	Array	Breadcrumb path
authenticityGuarantee, topRatedSeller, businessSeller	Boolean	Trust badges
listingType, bids, bidCount, timeLeft	Mixed	Sale format and auction data
vehicle	Object	VIN, mileage and other eBay Motors fields (only on vehicle listings)
marketplace	String	Marketplace code
searchUrl, storeListingUrl	String	Page that produced the record
storeName, storeUrl, storeTagline, storeFeedbackPercent, storeItemsSold, storeFollowers, storeListingCount	Mixed	Store context attached to store-mode records
storeCategoryName, storeCategoryUrl, storeCategoryId	String	Category context attached to store-category records
scrapedAt	String	ISO 8601 scrape time

Example output

{
    "recordType": "item",
    "id": "257633093777",
    "itemId": "257633093777",
    "url": "https://www.ebay.com/itm/257633093777",
    "title": "Lenovo ThinkBook 15-ITL 15.6\" Core i5 16GB RAM 256GB SSD Windows 11 Pro Laptop",
    "price": "US $339.99",
    "priceValue": 339.99,
    "priceCurrency": "USD",
    "condition": "Good - Refurbished",
    "brand": "Lenovo",
    "model": "Lenovo ThinkBook 15 ITL",
    "mpn": "lenovodeals",
    "color": "Gray",
    "seller": "Discount Computer Depot",
    "sellerFeedbackScore": "178796",
    "sellerFeedbackCount": 178796,
    "sellerFeedbackPercent": "99.6%",
    "sellerUrl": "https://www.ebay.com/str/discountcomputerdepot",
    "availableQuantity": "10",
    "quantityAvailable": 10,
    "soldCount": "29",
    "quantitySold": 29,
    "watchCount": "183",
    "watcherCount": 183,
    "location": "Jacksonville, Texas, United States",
    "shippingCost": "Free shipping",
    "returnPolicy": "30 days returns",
    "returnDays": 30,
    "paymentMethods": ["PayPal", "Visa", "Master Card"],
    "listingStartDate": "2026-07-20T20:20:59Z",
    "images": ["https://i.ebayimg.com/images/g/example/s-l1600.jpg"],
    "itemSpecifics": {"Brand": "Lenovo", "Processor": "Intel Core i5-1135G7"},
    "categories": ["eBay", "Electronics", "Computers/Tablets & Networking"],
    "authenticityGuarantee": false,
    "topRatedSeller": true,
    "businessSeller": false,
    "listingType": "Buy It Now",
    "marketplace": "US",
    "scrapedAt": "2026-11-09T10:00:00+00:00"
}

How pagination works

• Search and store listing pages accept 60, 120 or 240 rows per page; the actor right-sizes the page to the remaining maxItems.
• 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.
• Pagination stops on maxItems, the last page, a page with no new item IDs, or a repeated page.

Tips for reliable runs

1. For a handful of listings, use Item details with item IDs.
2. For a seller's catalogue, use Store inventory and set maxPages high enough for the store size.
3. To split a large store, copy category links from the store page into Store category.
4. Keep includeItemDetails on when you need specifics, images and return terms; turn it off when card-level title/price is enough.
5. maxItems is shared by all sources, so size it for the total you want.

FAQ

Do I need cookies, an account or a proxy?

No. The actor reads public pages and selects its network path automatically. There is no proxy field to configure and no credential to paste.

Why are some fields missing on a record?

eBay 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.

Can I use UK, German or Australian eBay?

Yes. 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.

Does it support sold or completed listings?

No. eBay puts sold/completed search behind a sign-in wall, and this actor deliberately never uses cookies or logins. Active listings only.

Can I get the full store inventory?

Yes, until the store's own pagination ends or maxItems is reached. Use maxPages to control how deep it walks.

What is the difference between Store inventory and Store category?

Store inventory walks the whole store. Store category walks one category inside the store; use it to partition very large stores into smaller runs.

Limitations

• Sold and completed listings require an eBay sign-in, so they are out of scope.
• eBay caps a single result set at 200 pages; split large sweeps by category or price band.
• A few card fields (rating, watchers, sold count) are only shown by eBay on some listings; they are omitted when absent.
• 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.