eBay Catalogue by Category

Pulls every product on an eBay category listing across five European storefronts (Germany, United Kingdom, France, Italy and Spain), one row per product with price, currency, seller, stock and the position it held on the page. Built for brand and category teams who need a complete, repeatable snapshot of an eBay category instead of a hand-picked sample.

What you get

• Full coverage page by page, with category, category_title, breadcrumbs, page and position on every row, so the exact shelf order is rebuildable.
• Prices as numbers, not strings: price, original_price and currency per storefront (EUR on .de, .fr, .it and .es, GBP on .co.uk).
• Identity you can join on: id is the eBay listing id, plus product_url and image_url.
• is_sponsored on every row. eBay serves category pages from its browse grid, which carries no promoted marker, so this reads false there. Use the eBay Keyword Rank Tracker for paid slots.
• expandSubcategories walks the child categories eBay exposes and tags each row with its parent_category.
• Nothing is silently dropped: run stats count failed_categories, non_listing_pages and not_found.

Input

Give it one or more category ids or listing URLs and a storefront. Everything else has a working default.

{
  "categories": ["177661"],
  "locale": "de",
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  },
  "expandSubcategories": false,
  "delayMs": 1200,
  "callsPerSession": 60
}

• categories (required): ids such as 177661, or URLs such as https://www.ebay.de/b/Shampoos/177661/bn_7005421. Ids are listed at https://www.ebay.de/n/all-categories.
• locale: de, uk, fr, it or es. Default de.
• maxPages: pages per category. 0 means every page the category has.
• expandSubcategories: also crawl the children eBay links from the category page.
• proxyConfiguration: residential in the storefront's country, already the default.

Output

One dataset row per product, in listing order.

{
  "platform": "ebay",
  "locale": "de",
  "category": "177661",
  "category_title": "Shampoos & Spülungen",
  "breadcrumbs": "eBay > Beauty & Gesundheit > Haarpflege & Haarstyling",
  "page": 1,
  "position": 1,
  "id": "397279406802",
  "name": "125ml Plantur DMG CLINICAL Serum Kopfhaut Leave-in Coffein Formel",
  "brand": null,
  "price": 19.99,
  "original_price": null,
  "currency": "EUR",
  "in_stock": true,
  "is_sponsored": false,
  "seller": null,
  "product_url": "https://www.ebay.de/itm/397279406802",
  "fetched_at": "2026-09-12T03:24:15.531Z"
}

eBay category cards publish no brand and no star rating, so brand, rating, rating_count and original_price come back null on most rows. parent_category is null unless the row came from expandSubcategories.

Use cases

• Assortment tracking: count listings per category over time from id, category and fetched_at.
• Price and discount monitoring across five storefronts on one schedule, from price, original_price and currency.
• Shelf-share analysis: position and page show who occupies the visible top of a category.
• Delisting alerts by diffing id sets between two runs.

Notes and limits

• A verified run on ebay.de category 177661 returned 102 products from a single page. Pages are requested at 120 items each.
• Category listings carry no promoted marker, so is_sponsored is false on every catalogue row. Sponsored data lives in the keyword rank actor.
• Only category ids and category URLs are accepted. A search URL is rejected with a clear log line and counted in failed_categories.
• eBay refuses a share of residential exits when the session is created. The actor retries on a fresh exit up to six times, which is why a first page can take a few minutes.
• seller is read from the feedback line on the card and is often null on browse grids.

FAQ

Do I need a proxy? Yes. Residential in the storefront's country (DE, GB, FR, IT or ES). That is the default in the input.

How many results can I get? maxPages: 0 walks the whole category, at 120 items per page. One verified page returned 102 rows.

Does it need a login or an API key? No. No eBay account and no API key.

How is a category resolved? From the numeric eBay category id. Paste a /b/... or /sch/... URL and the id is read out of it.