eBay Similar Product Actor ## Overview The eBay Similar Product Actor is a web scraping tool deployed on the Apify platform that retrieves similar products from eBay based on a given product URL. This actor helps users discover alternative or related products by leveraging eBay's similar product recommendations. ## Features - Product Discovery: Find similar products to any eBay listing - Multi-Country Support: Support for 30+ eBay regional sites worldwide - Pagination: Navigate through multiple pages of similar products - Structured Data: Returns clean, structured product information - Real-time Scraping: Fetches live data from eBay ## Input Parameters ### Required Parameters | Parameter | Type | Description | |-----------|------|-------------| | productUrl | string | The eBay product URL to find similar items for | ### Optional Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | countryIso | string | "us" | Two-letter country ISO code for eBay regional site | | page | integer | 1 | Page number for pagination (starting from 1) | ### Supported Countries The actor supports the following eBay regional sites: Primary Markets: - us - United States - uk - United Kingdom - de - Germany - fr - France - it - Italy - es - Spain - ca - Canada - au - Australia Additional Markets: - at - Austria - be - Belgium - ch - Switzerland - hk - Hong Kong - ie - Ireland - my - Malaysia - nl - Netherlands - nz - New Zealand - ph - Philippines - pl - Poland - sg - Singapore - 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 Example json { "productUrl": "https://www.ebay.com/itm/326453180272", "countryIso": "us", "page": 1 } ## Output Format The actor returns an array of similar products with the following structure: ### Output Fields | Field | Type | Description | |-------|------|-------------| | id | string | eBay item ID | | title | string | Product title | | imageUrl | string | Product thumbnail image URL | | price | number | Product price | | currency | string | Price currency (e.g., "USD") | | purchaseOption | string | Purchase type (e.g., "Buy It Now") | | condition | string | Item condition (e.g., "New", "Pre-owned") | | shipping | string | Shipping information | | sellerIdVariant | string | Encrypted seller identifier | | url | string | Direct link to the product page | ## Output Example json [ { "id": "356903294036", "title": "Size 4 - Air Jordan 1 SE Mid Vivid Orange", "imageUrl": "https://i.ebayimg.com/thumbs/images/g/CvkAAeSwDnNoJlcR/s-l500.jpg", "price": 50, "currency": "USD", "purchaseOption": "Buy It Now", "condition": "New", "shipping": "+ shipping", "sellerIdVariant": "AQAKAAAAEArrPnZ42u4UpWhqwrqbVjI=", "url": "https://www.ebay.com/itm/356903294036?_trkparms=..." }, { "id": "396645186040", "title": "Nike Air Jordan 1 Men's Retro High OG White Cement", "imageUrl": "https://i.ebayimg.com/thumbs/images/g/bb8AAeSwCVVoMH9O/s-l500.jpg", "price": 76.77, "currency": "USD", "purchaseOption": "Buy It Now", "condition": "Pre-owned", "shipping": "+ shipping", "sellerIdVariant": "AQAKAAAAEJntWH47bomOQtzB2RXGI/c=", "url": "https://www.ebay.com/itm/396645186040?_trkparms=..." } ] ## Usage Instructions ### Running the Actor 1. Access the Actor: Navigate to the eBay Similar Product Actor on Apify 2. Configure Input: Set your input parameters: - Enter the eBay product URL you want to find similar items for - Select the appropriate country ISO code - Specify the page number if needed 3. Run the Actor: Click "Start" to begin the scraping process 4. Download Results: Once complete, download the results in JSON, CSV, or other formats ### API Usage You can also run this actor via Apify's API: bash curl -X POST https://api.apify.com/v2/acts/<the-actor-id>/runs \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "productUrl": "https://www.ebay.com/itm/326453180272", "countryIso": "us", "page": 1 }' ## Use Cases ### E-commerce Intelligence - Competitive Analysis: Monitor similar products and pricing - Market Research: Discover product alternatives and market trends - Price Comparison: Compare prices across similar listings ### Business Applications - Inventory Planning: Find alternative products to stock - Product Sourcing: Discover new suppliers and product variations - Market Expansion: Research products in different regional markets ### Personal Use - Shopping Assistance: Find cheaper or better alternatives - Product Discovery: Explore similar items before making a purchase - Price Monitoring: Track similar products for better deals ## Best Practices ### Input Optimization - Valid URLs: Ensure the product URL is a valid eBay listing - Active Listings: Use URLs from currently active listings for best results - Correct Country: Match the country ISO with the product URL's regional site ### Rate Limiting - Respectful Usage: Avoid running multiple instances simultaneously - Pagination: Use pagination instead of running separate actors for large datasets - Monitoring: Monitor your Apify usage to stay within limits ### Error Handling - Invalid URLs: The actor will handle invalid URLs gracefully - Network Issues: Temporary network issues are automatically retried - Regional Restrictions: Some products may not be available in all regions ## Troubleshooting ### Common Issues No Results Returned - Verify the product URL is correct and active - Check if the product has similar items available - Try different country ISO codes Slow Performance - eBay's servers may be slow during peak hours - Consider running during off-peak times - Use pagination to process smaller batches Regional Differences - Product availability varies by country - Prices and currencies will differ by region - Some products may be region-restricted --- ## 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. ---