eBay Products By Category Actor ## Overview The eBay Products By Category Actor is an Apify actor designed to scrape product listings from eBay category pages. This actor extracts detailed product information including titles, prices, images, conditions, shipping details, and more from any eBay category URL. ## Features - Category-based scraping: Extract all products from any eBay category page - Multi-country support: Support for 30+ eBay regional sites - Comprehensive data extraction: Captures product titles, prices, images, conditions, shipping info, and metadata - JSON output: Returns structured data in JSON format - Error handling: Robust error handling and logging ## Input Parameters ### Required Parameters | Parameter | Type | Description | |-----------|------|-------------| | categoryUrl | string | The eBay category URL to scrape products from | ### Optional Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | countryIso | string | "us" | Two-letter ISO country code for eBay regional site | ### Supported Country Codes The actor supports the following eBay regional sites: Primary Markets: - au - Australia - at - Austria - be - Belgium - ca - Canada - ch - Switzerland - de - Germany - es - Spain - fr - France - hk - Hong Kong - ie - Ireland - it - Italy - my - Malaysia - nl - Netherlands - nz - New Zealand - ph - Philippines - pl - Poland - sg - Singapore - uk - United Kingdom - us - United States - usa - United States (alternative) Additional Markets: - ar - Argentina - br - Brazil - cn - China - co - Colombia - cz - Czech Republic - dk - Denmark - fi - Finland - gr - Greece - hu - Hungary - id - Indonesia - il - Israel - in - India - jp - Japan - kr - South Korea - mx - Mexico - no - Norway - se - Sweden - th - Thailand - tw - Taiwan - vn - Vietnam ## Input Schema Example json { "categoryUrl": "https://www.ebay.com/b/3D-Printers-Supplies/183062/bn_55163226?_pgn=1&_sop=15", "countryIso": "us" } ## Output Format The actor returns an array of product objects with the following structure: json [ { "title": "Product title", "price": 87, "currency": "USD", "url": "https://www.ebay.com/itm/...", "imageUrl": "https://i.ebayimg.com/thumbs/images/...", "condition": "Novo em folha", "shipping": "Frete grátis", "isAuction": false, "bids": null, "extraInfo": "Additional information like sold count" } ] ### Output Fields Description | Field | Type | Description | |-------|------|-------------| | title | string | Product title/name | | price | number | Product price (numeric value) | | currency | string | Currency code (e.g., "USD", "EUR") | | url | string | Direct link to the product page | | imageUrl | string | URL of the product's main image | | condition | string | Product condition (New, Used, etc.) | | shipping | string | Shipping information | | isAuction | boolean | Whether the listing is an auction | | bids | number/null | Number of bids (for auctions) | | extraInfo | string | Additional information (sold count, etc.) | ## Usage Examples ### Basic Usage json { "categoryUrl": "https://www.ebay.com/b/Cell-Phones-Smart-Watches/15032/bn_1865441" } ### With Country Specification json { "categoryUrl": "https://www.ebay.de/b/Smartphones/9355/bn_1865441", "countryIso": "de" } ### Advanced Category with Filters json { "categoryUrl": "https://www.ebay.com/b/3D-Printers-Supplies/183062/bn_55163226?_pgn=1&_sop=15&_udlo=10&_udhi=100", "countryIso": "us" } ## How to Use 1. Set up input: Configure the categoryUrl parameter with your target eBay category URL 2. Choose region: Select the appropriate countryIso code for your target market 3. Run the actor: Execute the actor through Apify Console, API, or SDK 4. Retrieve results: Access the scraped data from the actor's dataset ### Using Apify SDK javascript import { ApifyApi } from 'apify-client'; const client = new ApifyApi({ token: 'YOUR_APIFY_TOKEN' }); const input = { categoryUrl: 'https://www.ebay.com/b/Electronics/293/bn_1865334', countryIso: 'us' }; const run = await client.actor('THE_ACTOR_ID').call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ## Error Handling The actor includes comprehensive error handling: - Network errors: Automatic retries for failed requests - Invalid URLs: Validation of category URLs - Rate limiting: Built-in delays to respect eBay's rate limits - Data parsing errors: Graceful handling of malformed data ## Performance Notes - The actor processes one category page per run - Processing time varies based on the number of products in the category - Memory usage scales with the number of products extracted - Recommended for categories with up to 1000 products per run ## Limitations - Only scrapes the first page of category results (use pagination parameters in URL for additional pages) - Requires valid eBay category URLs - Some product details may vary based on eBay's regional differences ## Best Practices 1. URL Format: Ensure category URLs are properly formatted and accessible 2. Rate Limiting: Allow sufficient time between runs to avoid being blocked 3. Country Selection: Choose the correct country ISO code for accurate regional data 4. Error Monitoring: Monitor actor runs for any errors or failures 5. Data Validation: Validate extracted data before using in production systems --- ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Email: pintoflowpt@gmail.com * Apify Platform: You can also contact us directly through this platform. ---