# eBay Real-Time Data Scraper — Search, Listings, Sellers & Deals (`b2b_leads/ebay-real-time-data`) Actor Real-time eBay scraper for search, listing details, seller feedback, store profiles, catalog products, deals & category browse. 20 marketplaces, 8 checkbox features, CAPTCHA-ready, residential proxy support. Clean JSON—perfect for sellers, researchers & API workflows. - **URL**: https://apify.com/b2b\_leads/ebay-real-time-data.md - **Developed by:** [Chidubem Aneke](https://apify.com/b2b_leads) (community) - **Categories:** E-commerce, Developer tools, SEO tools - **Stats:** 2 total users, 1 monthly users, 92.3% 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 Real-Time Data — Live eBay Listing Scraper **Stop fighting eBay's Akamai walls.** This Actor delivers **live product search, listing details, seller feedback, seller profiles, catalog products, deals, category browse, and URL scraping** as clean JSON — across **20 marketplaces**, with **built-in CAPTCHA handling** and **residential proxy** support. No coding. No 2Captcha account. No scraper maintenance. Turn on only the features you need, pick your country, click **Start**, and export or pipe results to Slack, Sheets, Zapier, or your own API. --- ### Why teams choose this Actor - **Real-time data** — prices, conditions, seller scores, and listing metadata scraped fresh each run - **Eight tools in one** — search, PDP details, seller feedback, seller profile, catalog product, URL scraper, category browse, and deals - **Checkbox UX** — enable only what you need; Product Search is on by default - **20 eBay stores** — US, UK, DE, FR, IT, ES, AU, CA, AT, CH, IE, NL, BE, PL, SG, MY, PH, HK, MX, BR - **CAPTCHA-ready** — Akamai splash and robot checks handled internally; you never configure API keys - **Structured JSON** — every row tagged with `featureType` for easy filtering and integrations - **Apify-native** — schedule runs, webhooks, API access, CSV/Excel export out of the box --- ### Who is this for? | You are… | You get… | |----------|----------| | **eBay seller or brand** | Competitor prices, seller scores, listing conditions, store profiles | | **Market researcher** | Category browse data, search SERPs, seller reputation, catalog product specs | | **Deal hunter or affiliate** | Fresh deal feeds with discounts and item IDs | | **Agency or consultant** | Client-ready datasets without building scrapers | | **Reseller or arbitrage trader** | Live item lookup, catalog matching, and pricing before you list | | **Developer** | Clean JSON via Apify API — a practical **eBay data API alternative** without Trading API onboarding | --- ### What you get every run Structured records in your Apify dataset, ready to export or integrate: | Field | Meaning | |-------|---------| | `featureType` | Which feature produced the row | | `country` | Marketplace (US, UK, DE, …) | | `url` | Source page | | `scrapedAt` | ISO timestamp | | **Plus** | itemId, epid, title, price, currency, condition, buyingFormat, seller, feedback, images, and more | Filter by `featureType`, download CSV, or hit the dataset API — same workflow for every feature. --- ### Eight features — use one or all #### 🔍 Product Search *(on by default)* Keyword search with item ID, title, price, condition, buying format, seller username, and SERP position. Filter by condition, format, and show-only flags. *Example:* `"wireless mouse"` → 50 results on eBay US, sorted by price. --- #### 📦 Product Details Full listing page data for any item ID or URL: title, price, condition, quantity, shipping, item specifics, description, images, seller info. *Example:* Item `123456789012` → live price, specs, and seller feedback score in one row. --- #### ⭐ Seller Feedback Paginated seller feedback comments with type, rating, date, and linked item when available. *Example:* 50 recent feedback entries for seller `example_store`. --- #### 🔗 Scrape By URL Paste any eBay link — listing, search, deals, category, seller — and get structured data with automatic page-type detection. --- #### 📂 Category Browse Browse eBay category pages by category ID or URL. Collect listings with rank, price, and metadata. *Example:* Top 50 listings in category `171485` (PC Laptops & Netbooks) on eBay US. --- #### 🏷️ Deals eBay Deals hub with price, was-price, discount %, badge, and image. Filter by category and minimum discount. --- #### 🏪 Seller Profile Seller store page with feedback score, positive %, items sold, member since, location, store name, and optional active listings from that seller. *Example:* Profile + 20 active listings for seller `worldofbooks08`. --- #### 📚 Catalog Product eBay catalog product reference pages (ePID) with brand, model, MPN/UPC, specs, images, price range, and listing count across matching listings. *Example:* Catalog ePID `18034936573` → normalized product data for matching and enrichment. --- ### 20 eBay marketplaces Set **Marketplace country** once — domain, currency, and language follow for all enabled features: **US** · **UK** · **DE** · **FR** · **IT** · **ES** · **AU** · **CA** · **AT** · **CH** · **IE** · **NL** · **BE** · **PL** · **SG** · **MY** · **PH** · **HK** · **MX** · **BR** --- ### How to run 1. Click **Start** on this Actor page. 2. Choose your **marketplace country** (default: US). 3. **Check the features** you need — uncheck Product Search if you only want details, feedback, or deals. 4. Fill in keywords, item IDs, seller usernames, category IDs, catalog ePIDs, or URLs for the features you enabled. 5. Keep **Proxy → Residential** (recommended). 6. Run — download results or connect a **webhook** / **schedule**. **Pro tip:** Schedule daily runs for price tracking, deal digests, or seller reputation monitoring. --- ### Example inputs (API, MCP, and automation) Use these JSON payloads with the **Apify API**, **Apify MCP** (`call-actor`), or scheduled runs. In the Console, the same options map to the checkboxes and fields above. **Important:** Product Search is **on by default**. When running a single feature via API or MCP, set `"enableProductSearch": false` and enable only the feature you need. #### Product Search only ```json { "country": "US", "enableProductSearch": true, "searchKeywords": ["wireless mouse"], "searchMaxResultsPerKeyword": 10, "searchCondition": "new", "searchBuyingFormat": "buy-it-now" } ```` #### Product Details only ```json { "country": "US", "enableProductSearch": false, "enableProductDetails": true, "itemIds": ["123456789012"] } ``` #### Seller Feedback only ```json { "country": "US", "enableProductSearch": false, "enableSellerFeedback": true, "sellerUsernames": ["example_seller"], "feedbackMaxPerSeller": 25 } ``` #### Scrape By URL only ```json { "country": "US", "enableProductSearch": false, "enableScrapeByUrl": true, "scrapeUrls": ["https://www.ebay.com/itm/123456789012"] } ``` #### Category Browse only ```json { "country": "US", "enableProductSearch": false, "enableCategoryBrowse": true, "categoryIds": ["171485"], "categoryMaxProducts": 25 } ``` #### Deals only ```json { "country": "US", "enableProductSearch": false, "enableDeals": true, "dealsMaxProducts": 30, "dealsOffset": 0 } ``` #### Seller Profile only ```json { "country": "US", "enableProductSearch": false, "enableSellerProfile": true, "sellerUsernames": ["worldofbooks08"], "includeSellerProducts": true, "sellerProductsMaxResults": 20 } ``` #### Catalog Product only ```json { "country": "US", "enableProductSearch": false, "enableCatalogProduct": true, "catalogEpids": ["18034936573"] } ``` #### Multiple features in one run ```json { "country": "US", "enableProductSearch": false, "enableProductDetails": true, "enableCatalogProduct": true, "itemIds": ["123456789012"], "catalogEpids": ["18034936573"] } ``` Filter output rows by `featureType`. Dataset views: `overview`, `search`, `details`, `feedback`, `deals`, `category`, `sellers`, `catalog`. *** ### Output fields by featureType #### `product_search` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `product_search` | | `keyword` | string | Search term | | `position` | integer | Rank on SERP (1-based) | | `itemId` | string | Numeric eBay item ID | | `title` | string | Listing title | | `price` | number | Current price | | `currency` | string | ISO currency | | `condition` | string | Item condition | | `buyingFormat` | string | Auction, Buy It Now, etc. | | `sellerUsername` | string | Seller username | | `sellerFeedbackScore` | integer | Seller feedback score | | `imageUrl` | string | Primary image URL | | `url` | string | Listing URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | #### `product_details` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `product_details` | | `itemId` | string | Item ID | | `title` | string | Listing title | | `price` | number | Current price | | `currency` | string | ISO currency | | `condition` | string | Item condition | | `buyingFormat` | string | Listing format | | `quantity` | integer | Available quantity | | `shipping` | string | Shipping summary | | `itemSpecifics` | array | `{ name, value }` pairs | | `description` | string | Listing description | | `imageUrls` | array | Gallery URLs | | `seller` | object | `{ username, feedbackScore, feedbackPercentage, storeName }` | | `url` | string | Listing URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | #### `seller_feedback` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `seller_feedback` | | `seller` | string | Seller username | | `feedbackId` | string | Feedback entry ID | | `feedbackComment` | string | Comment text | | `feedbackType` | string | Positive / Neutral / Negative | | `rating` | number | Star rating if shown | | `feedbackDate` | string | Date string | | `itemId` | string | Related item ID | | `title` | string | Related item title | | `url` | string | Feedback profile URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | #### `scrape_by_url` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `scrape_by_url` | | `pageType` | string | Detected page type (listing, search, deals, …) | | `itemId` | string | Item ID when applicable | | `title` | string | Page or listing title | | `price` | number | Price when applicable | | `currency` | string | Currency when applicable | | `data` | object | Parsed payload for detected type | | `url` | string | Source URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | #### `category_browse` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `category_browse` | | `itemId` | string | Item ID | | `title` | string | Listing title | | `price` | number | Price | | `categoryId` | string | Category ID | | `position` | integer | Rank on category page | | `rating` | number | Star rating if shown | | `reviewCount` | integer | Review count if shown | | `imageUrl` | string | Primary image | | `url` | string | Listing URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | #### `deals` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `deals` | | `itemId` | string | Item ID | | `title` | string | Listing title | | `price` | number | Deal price | | `originalPrice` | number | Was price | | `discountPercent` | number | Discount percentage | | `dealBadge` | string | Deal label | | `rating` | number | Star rating if shown | | `reviewCount` | integer | Review count if shown | | `imageUrl` | string | Primary image | | `url` | string | Deal URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | #### `seller_profile` and `seller_products` Seller Profile returns one **`seller_profile`** row per username, plus optional **`seller_products`** rows when `includeSellerProducts` is true. | Field | Type | Applies to | Description | |-------|------|------------|-------------| | `featureType` | string | both | `seller_profile` or `seller_products` | | `username` | string | profile | Seller username | | `sellerUsername` | string | products | Seller username | | `feedbackScore` | number | profile | Total feedback score | | `positiveFeedbackPercent` | number | profile | Positive feedback % | | `itemsSold` | number | profile | Items sold count | | `memberSince` | string | profile | Registration date | | `location` | string | profile | Seller location | | `storeName` | string | profile | Store display name | | `storeDescription` | string | profile | Store about text | | `storeUrl` | string | profile | Store page URL | | `itemId` | string | products | Listing item ID | | `title` | string | products | Listing title | | `price` | number | products | Listing price | | `currency` | string | products | ISO currency | | `condition` | string | products | Item condition | | `imageUrl` | string | products | Primary image | | `position` | integer | products | Rank in seller listings | | `url` | string | both | Source URL | | `country` | string | both | Marketplace code | | `scrapedAt` | string | both | ISO timestamp | #### `catalog_product` | Field | Type | Description | |-------|------|-------------| | `featureType` | string | Always `catalog_product` | | `epid` | string | eBay catalog product ID (ePID) | | `title` | string | Catalog product title | | `brand` | string | Brand name | | `model` | string | Model name | | `mpn` | string | Manufacturer part number | | `upc` | string | UPC barcode | | `images` | array | Product image URLs | | `aggregateRating` | number | Average star rating | | `reviewCount` | integer | Review count | | `priceRange` | string | Price range across listings | | `listingCount` | integer | Number of matching listings | | `productSpecs` | array | `{ name, value }` spec pairs | | `category` | string | Category breadcrumb or name | | `url` | string | Catalog page URL | | `country` | string | Marketplace code | | `scrapedAt` | string | ISO timestamp | *** ### featureType reference (dataset API filtering) Use these values in dataset queries, webhooks, and downstream ETL: | `featureType` | Feature checkbox | Description | |---------------|------------------|-------------| | `product_search` | `enableProductSearch` | Keyword search SERP results | | `product_details` | `enableProductDetails` | Listing detail pages | | `seller_feedback` | `enableSellerFeedback` | Seller feedback comments | | `scrape_by_url` | `enableScrapeByUrl` | Auto-detected URL scrape | | `category_browse` | `enableCategoryBrowse` | Category page listings | | `deals` | `enableDeals` | eBay Deals hub | | `seller_profile` | `enableSellerProfile` | Seller store profile summary | | `seller_products` | `enableSellerProfile` + `includeSellerProducts` | Active listings from seller | | `catalog_product` | `enableCatalogProduct` | eBay catalog reference page | Example dataset filter (Apify API): ``` GET /v2/datasets/{datasetId}/items?filter={"featureType":"product_search"} ``` *** ### Apify API — sync run with dataset items Run the Actor synchronously and return dataset rows in one request: ``` POST https://api.apify.com/v2/acts/{actorId}/run-sync-get-dataset-items?token={APIFY_TOKEN} Content-Type: application/json { "country": "US", "enableProductSearch": false, "enableDeals": true, "dealsMaxProducts": 10 } ``` Replace `{actorId}` with this Actor's ID (e.g. `username~ebay-real-time-data`). Add `&format=json` for JSON (default) or use view parameters such as `&view=search`. **MCP:** Connect via [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) and use `call-actor` with the same JSON payloads above — ideal for LLM agents that need live eBay data without writing HTTP clients. *** ### Proxy configuration eBay uses Akamai bot protection. **Apify Proxy → Residential** is strongly recommended and set as the default in `proxyConfiguration`: ```json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" } } ``` Match `apifyProxyCountry` to your marketplace when possible (e.g. `GB` for UK). Datacenter proxies often fail on eBay. *** ### Example workflows **Competitor monitoring** — Product Search + Product Details on your keyword list → daily schedule → webhook when price or seller changes. **Seller due diligence** — Seller Profile + Seller Feedback on a username → CSV export for reputation review. **Catalog enrichment** — Catalog Product on ePIDs → match listings to normalized brand/model/UPC data. **Morning deal feed** — Deals with 50–100 items → Google Sheets or email via Zapier every morning. **Category report** — Category Browse on `171485` → weekly snapshot for trend decks. *** ### Integrations Works with the full Apify ecosystem: - **Webhooks** on run success - **REST API** for dataset items - **Slack**, **Google Sheets**, **Zapier**, **Make**, **Airbyte**, custom ETL - **Scheduled runs** for hands-off **price monitoring** and deal alerts - **Apify MCP** for LLM and agent workflows *** ### This Actor vs alternatives | Approach | Problem | This Actor | |----------|---------|------------| | Copy-paste | Slow, doesn't scale | Automated, repeatable | | DIY scripts | Break on HTML changes; CAPTCHA pain | Maintained parsers + built-in CAPTCHA recovery | | eBay Trading API | Seller approval, limited public data | Broad coverage of public pages | | Generic scrapers | No eBay-specific fields | Purpose-built for SERP, PDP, deals, sellers, catalog | You pay for the scrape you need — enable only the checkboxes that matter. *** ### FAQ **Do I need to write code?**\ No. Configure inputs, run, export. Developers can use the Apify API or MCP for full automation. **Do I need a 2Captcha account?**\ No. CAPTCHA and Akamai splash handling is built into the Actor and configured by the developer on Apify. You do not add API keys — just use residential proxy and run. **Which proxy should I use?**\ **Apify Proxy → Residential**, country matched to your marketplace. This is the default and works best on eBay. **Can I run multiple features in one run?**\ Yes. Enable any combination — each record is tagged with `featureType` so you can split results downstream. **What's the difference between Seller Feedback and Seller Profile?**\ **Seller Feedback** returns individual feedback comments. **Seller Profile** returns store summary data (score, location, member since) and optionally active listings (`seller_products` rows). **What's a catalog product (ePID)?**\ eBay's catalog reference pages (`/p/{epid}`) group listings under a normalized product identity — useful for matching, enrichment, and UPC/MPN lookup. **Does Product Search run by default?**\ Yes. Uncheck it if you only want details, feedback, deals, seller profile, or catalog scraping. **What memory and timeout should I use?**\ **2048 MB** and **900 s** (defaults) work for most runs. Increase memory for large multi-feature batches. *** ### Get started now 1. Click **Try for free** or **Start**. 2. Pick your marketplace and features. 3. Use **Residential proxy**. 4. Run — then **schedule** or **integrate**. **Live eBay data. Structured JSON. Zero maintenance.** # Actor input Schema ## `country` (type: `string`): eBay marketplace to scrape. Drives domain, currency, and language headers. ## `enableProductSearch` (type: `boolean`): Search eBay by keyword and return matching listings from search results. ## `searchKeywords` (type: `array`): One or more keywords to search (1–20). Required when Product Search is enabled. ## `searchMaxResultsPerKeyword` (type: `integer`): Maximum listings to return per keyword (1–100). ## `searchPage` (type: `integer`): First search results page to scrape (1-based). ## `searchMaxPages` (type: `integer`): Number of search result pages to crawl per keyword. ## `searchSort` (type: `string`): How to sort search results on eBay. ## `searchCategoryId` (type: `string`): Restrict search to an eBay category using its numeric category ID. ## `searchCondition` (type: `string`): Filter search results by item condition. ## `searchBuyingFormat` (type: `string`): Filter by listing format. ## `searchShowOnly` (type: `array`): Additional eBay search filters. Allowed values per entry: free-shipping, returns-accepted, authorized-seller, deals, completed, sold. ## `enableProductDetails` (type: `boolean`): Fetch full listing page data for specific item IDs or URLs. ## `itemIds` (type: `array`): Numeric eBay item IDs to scrape (e.g. 123456789012). ## `productUrls` (type: `array`): Alternative to item IDs — paste full eBay listing URLs. ## `includeDescription` (type: `boolean`): Include listing description text in output. ## `includeImages` (type: `boolean`): Include listing image URLs in output. ## `enableSellerFeedback` (type: `boolean`): Scrape seller feedback ratings and recent comments for given usernames. ## `sellerUsernames` (type: `array`): eBay seller usernames for Seller Feedback and/or Seller Profile features. ## `feedbackMaxPerSeller` (type: `integer`): Maximum feedback comments to collect per seller (1–100). ## `feedbackPeriod` (type: `string`): Time window for feedback entries. ## `feedbackPage` (type: `integer`): First feedback page to scrape (1-based). ## `feedbackMaxPages` (type: `integer`): Number of feedback pages to crawl per seller. ## `feedbackProductId` (type: `string`): Only collect feedback related to this eBay item ID. ## `feedbackFilterRating` (type: `string`): Filter feedback by rating type. ## `enableSellerProfile` (type: `boolean`): Scrape seller store pages: feedback score, member since, location, store info, and optional active listings. ## `includeSellerProducts` (type: `boolean`): When Seller Profile is enabled, also scrape the seller's active listings as seller\_products rows. ## `sellerProductsMaxResults` (type: `integer`): Maximum active listing rows to return per seller when includeSellerProducts is true (1–100). ## `enableCatalogProduct` (type: `boolean`): Scrape eBay catalog/ePID product pages: specs, aggregate ratings, price range, and listing count. ## `catalogEpids` (type: `array`): Numeric eBay product catalog IDs (ePID) to scrape, e.g. 123456789. ## `catalogUrls` (type: `array`): Full eBay catalog page URLs (alternative to catalogEpids). ## `enableScrapeByUrl` (type: `boolean`): Scrape arbitrary eBay URLs with auto page-type detection. ## `scrapeUrls` (type: `array`): eBay URLs to scrape. ## `scrapeExtractType` (type: `string`): Force a page type instead of auto-detection. ## `scrapeMaxPages` (type: `integer`): Pages to crawl for paginated list/feedback URLs. ## `enableCategoryBrowse` (type: `boolean`): Browse eBay category pages and collect listings. ## `categoryIds` (type: `array`): Numeric eBay category IDs to browse. ## `categoryUrls` (type: `array`): Full eBay category page URLs (alternative to category IDs). ## `categoryMaxProducts` (type: `integer`): Maximum listings to return per category (1–100). ## `categoryQuery` (type: `string`): Optional keyword to narrow listings within the category. ## `categoryPage` (type: `integer`): First category results page (1-based). ## `categoryMaxPages` (type: `integer`): Number of result pages to crawl per category. ## `enableDeals` (type: `boolean`): Scrape eBay Deals hub pages. ## `dealsMaxProducts` (type: `integer`): Maximum number of deals to return (1–100). ## `dealsCategoryId` (type: `string`): Filter deals by eBay category ID. ## `dealsMinDiscountPercent` (type: `number`): Only include deals with at least this discount percentage. ## `dealsOffset` (type: `integer`): Starting offset for paginated deals pages. ## `proxyConfiguration` (type: `object`): Use Apify Proxy with US Residential for best results on eBay. Leave the default unless you know you need something else. ## Actor input object example ```json { "country": "US", "enableProductSearch": true, "searchKeywords": [ "wireless mouse" ], "searchMaxResultsPerKeyword": 10, "searchPage": 1, "searchMaxPages": 1, "searchSort": "best-match", "searchCategoryId": "", "searchCondition": "all", "searchBuyingFormat": "all", "searchShowOnly": [], "enableProductDetails": false, "itemIds": [], "productUrls": [], "includeDescription": true, "includeImages": true, "enableSellerFeedback": false, "sellerUsernames": [], "feedbackMaxPerSeller": 10, "feedbackPeriod": "all", "feedbackPage": 1, "feedbackMaxPages": 5, "feedbackProductId": "", "feedbackFilterRating": "all", "enableSellerProfile": false, "includeSellerProducts": true, "sellerProductsMaxResults": 20, "enableCatalogProduct": false, "catalogEpids": [], "catalogUrls": [], "enableScrapeByUrl": false, "scrapeUrls": [], "scrapeExtractType": "auto", "scrapeMaxPages": 1, "enableCategoryBrowse": false, "categoryIds": [], "categoryUrls": [], "categoryMaxProducts": 50, "categoryQuery": "", "categoryPage": 1, "categoryMaxPages": 5, "enableDeals": false, "dealsMaxProducts": 50, "dealsCategoryId": "", "dealsMinDiscountPercent": 0, "dealsOffset": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `allResults` (type: `string`): Complete dataset with every field from all enabled features in this run. ## `overview` (type: `string`): Compact table — feature type, item ID, title, price, rating, seller, and source URL. ## `search` (type: `string`): Search result rows only (featureType = product\_search). ## `details` (type: `string`): Listing detail page rows (featureType = product\_details). ## `feedback` (type: `string`): Seller feedback rows (featureType = seller\_feedback). ## `deals` (type: `string`): Deals hub rows (featureType = deals). ## `category` (type: `string`): Category browse rows (featureType = category\_browse). ## `sellers` (type: `string`): Seller profile rows (featureType = seller\_profile) and active listing rows (featureType = seller\_products). ## `catalog` (type: `string`): eBay catalog/ePID rows (featureType = catalog\_product). # 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 = { "searchKeywords": [ "wireless mouse" ] }; // Run the Actor and wait for it to finish const run = await client.actor("b2b_leads/ebay-real-time-data").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 = { "searchKeywords": ["wireless mouse"] } # Run the Actor and wait for it to finish run = client.actor("b2b_leads/ebay-real-time-data").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 '{ "searchKeywords": [ "wireless mouse" ] }' | apify call b2b_leads/ebay-real-time-data --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=b2b_leads/ebay-real-time-data", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eBay Real-Time Data Scraper — Search, Listings, Sellers & Deals", "description": "Real-time eBay scraper for search, listing details, seller feedback, store profiles, catalog products, deals & category browse. 20 marketplaces, 8 checkbox features, CAPTCHA-ready, residential proxy support. Clean JSON—perfect for sellers, researchers & API workflows.", "version": "0.0", "x-build-id": "nmU6Sdc1SK84IYfIF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/b2b_leads~ebay-real-time-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-b2b_leads-ebay-real-time-data", "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/b2b_leads~ebay-real-time-data/runs": { "post": { "operationId": "runs-sync-b2b_leads-ebay-real-time-data", "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/b2b_leads~ebay-real-time-data/run-sync": { "post": { "operationId": "run-sync-b2b_leads-ebay-real-time-data", "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": { "country": { "title": "Marketplace country", "enum": [ "US", "UK", "DE", "FR", "IT", "ES", "AU", "CA", "AT", "CH", "IE", "NL", "BE", "PL", "SG", "MY", "PH", "HK", "MX", "BR" ], "type": "string", "description": "eBay marketplace to scrape. Drives domain, currency, and language headers.", "default": "US" }, "enableProductSearch": { "title": "Product Search", "type": "boolean", "description": "Search eBay by keyword and return matching listings from search results.", "default": true }, "searchKeywords": { "title": "Search keywords", "type": "array", "description": "One or more keywords to search (1–20). Required when Product Search is enabled.", "default": [ "wireless mouse" ], "items": { "type": "string" } }, "searchMaxResultsPerKeyword": { "title": "Max results per keyword", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum listings to return per keyword (1–100).", "default": 10 }, "searchPage": { "title": "Start page", "minimum": 1, "maximum": 20, "type": "integer", "description": "First search results page to scrape (1-based).", "default": 1 }, "searchMaxPages": { "title": "Max pages per keyword", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of search result pages to crawl per keyword.", "default": 1 }, "searchSort": { "title": "Sort order", "enum": [ "best-match", "price-asc", "price-desc", "ending-soonest", "newly-listed", "distance" ], "type": "string", "description": "How to sort search results on eBay.", "default": "best-match" }, "searchCategoryId": { "title": "Category ID (optional)", "type": "string", "description": "Restrict search to an eBay category using its numeric category ID.", "default": "" }, "searchCondition": { "title": "Item condition", "enum": [ "all", "new", "used", "not-specified", "for-parts" ], "type": "string", "description": "Filter search results by item condition.", "default": "all" }, "searchBuyingFormat": { "title": "Buying format", "enum": [ "all", "auction", "buy-it-now", "best-offer", "classified" ], "type": "string", "description": "Filter by listing format.", "default": "all" }, "searchShowOnly": { "title": "Show only", "type": "array", "description": "Additional eBay search filters. Allowed values per entry: free-shipping, returns-accepted, authorized-seller, deals, completed, sold.", "default": [], "items": { "type": "string" } }, "enableProductDetails": { "title": "Product Details", "type": "boolean", "description": "Fetch full listing page data for specific item IDs or URLs.", "default": false }, "itemIds": { "title": "Item IDs", "type": "array", "description": "Numeric eBay item IDs to scrape (e.g. 123456789012).", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Listing URLs", "type": "array", "description": "Alternative to item IDs — paste full eBay listing URLs.", "default": [], "items": { "type": "string" } }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Include listing description text in output.", "default": true }, "includeImages": { "title": "Include images", "type": "boolean", "description": "Include listing image URLs in output.", "default": true }, "enableSellerFeedback": { "title": "Seller Feedback", "type": "boolean", "description": "Scrape seller feedback ratings and recent comments for given usernames.", "default": false }, "sellerUsernames": { "title": "Seller usernames", "type": "array", "description": "eBay seller usernames for Seller Feedback and/or Seller Profile features.", "default": [], "items": { "type": "string" } }, "feedbackMaxPerSeller": { "title": "Max feedback entries per seller", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum feedback comments to collect per seller (1–100).", "default": 10 }, "feedbackPeriod": { "title": "Feedback period", "enum": [ "all", "1-month", "6-months", "12-months" ], "type": "string", "description": "Time window for feedback entries.", "default": "all" }, "feedbackPage": { "title": "Feedback start page", "minimum": 1, "maximum": 20, "type": "integer", "description": "First feedback page to scrape (1-based).", "default": 1 }, "feedbackMaxPages": { "title": "Max feedback pages per seller", "minimum": 1, "maximum": 20, "type": "integer", "description": "Number of feedback pages to crawl per seller.", "default": 5 }, "feedbackProductId": { "title": "Filter by item ID (optional)", "type": "string", "description": "Only collect feedback related to this eBay item ID.", "default": "" }, "feedbackFilterRating": { "title": "Feedback rating filter", "enum": [ "all", "positive", "neutral", "negative" ], "type": "string", "description": "Filter feedback by rating type.", "default": "all" }, "enableSellerProfile": { "title": "Seller Profile", "type": "boolean", "description": "Scrape seller store pages: feedback score, member since, location, store info, and optional active listings.", "default": false }, "includeSellerProducts": { "title": "Include seller products", "type": "boolean", "description": "When Seller Profile is enabled, also scrape the seller's active listings as seller_products rows.", "default": true }, "sellerProductsMaxResults": { "title": "Max seller products", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum active listing rows to return per seller when includeSellerProducts is true (1–100).", "default": 20 }, "enableCatalogProduct": { "title": "Catalog Product Details", "type": "boolean", "description": "Scrape eBay catalog/ePID product pages: specs, aggregate ratings, price range, and listing count.", "default": false }, "catalogEpids": { "title": "Catalog ePIDs", "type": "array", "description": "Numeric eBay product catalog IDs (ePID) to scrape, e.g. 123456789.", "default": [], "items": { "type": "string" } }, "catalogUrls": { "title": "Catalog URLs", "type": "array", "description": "Full eBay catalog page URLs (alternative to catalogEpids).", "default": [], "items": { "type": "string" } }, "enableScrapeByUrl": { "title": "Scrape By URL", "type": "boolean", "description": "Scrape arbitrary eBay URLs with auto page-type detection.", "default": false }, "scrapeUrls": { "title": "eBay URLs", "type": "array", "description": "eBay URLs to scrape.", "default": [], "items": { "type": "string" } }, "scrapeExtractType": { "title": "Extract type", "enum": [ "auto", "listing", "search", "deals", "category", "seller", "feedback" ], "type": "string", "description": "Force a page type instead of auto-detection.", "default": "auto" }, "scrapeMaxPages": { "title": "Max pages per URL", "minimum": 1, "maximum": 10, "type": "integer", "description": "Pages to crawl for paginated list/feedback URLs.", "default": 1 }, "enableCategoryBrowse": { "title": "Category Browse", "type": "boolean", "description": "Browse eBay category pages and collect listings.", "default": false }, "categoryIds": { "title": "Category IDs", "type": "array", "description": "Numeric eBay category IDs to browse.", "default": [], "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs", "type": "array", "description": "Full eBay category page URLs (alternative to category IDs).", "default": [], "items": { "type": "string" } }, "categoryMaxProducts": { "title": "Max products per category", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum listings to return per category (1–100).", "default": 50 }, "categoryQuery": { "title": "Category search query (optional)", "type": "string", "description": "Optional keyword to narrow listings within the category.", "default": "" }, "categoryPage": { "title": "Category start page", "minimum": 1, "maximum": 20, "type": "integer", "description": "First category results page (1-based).", "default": 1 }, "categoryMaxPages": { "title": "Max pages per category", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of result pages to crawl per category.", "default": 5 }, "enableDeals": { "title": "Deals", "type": "boolean", "description": "Scrape eBay Deals hub pages.", "default": false }, "dealsMaxProducts": { "title": "Max deals", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of deals to return (1–100).", "default": 50 }, "dealsCategoryId": { "title": "Deals category ID (optional)", "type": "string", "description": "Filter deals by eBay category ID.", "default": "" }, "dealsMinDiscountPercent": { "title": "Minimum discount (%)", "minimum": 0, "type": "number", "description": "Only include deals with at least this discount percentage.", "default": 0 }, "dealsOffset": { "title": "Deals offset", "minimum": 0, "type": "integer", "description": "Starting offset for paginated deals pages.", "default": 0 }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "Use Apify Proxy with US Residential for best results on eBay. Leave the default unless you know you need something else.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```