eBay Product Reviews Actor ## Overview The eBay Product Reviews Actor is a powerful web scraping tool deployed on the Apify platform that extracts customer reviews and feedback for eBay products. This actor allows you to gather valuable insights from eBay product reviews across multiple countries and regions, with support for pagination and customizable parameters. ## Features - Multi-Region Support: Scrape reviews from eBay sites across 30+ countries - Pagination Support: Navigate through multiple pages of reviews - Customizable Results: Control the number of reviews per page (1-75) - Comprehensive Data: Extract detailed review information including ratings, comments, buyer details, and verification status - Statistics: Get overview statistics including total and revised feedback counts ## Input Parameters ### Required Parameters | Parameter | Type | Description | |-----------|------|-------------| | productUrl | string | The eBay product URL to scrape reviews from | ### Optional Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | countryIso | string | "us" | Two-letter ISO country code for eBay regional site | | page | integer | 1 | Page number for pagination (starting from 1) | | perPage | integer | 25 | Number of reviews per page (1-75) | ### Supported Countries The actor supports eBay sites from the following countries: Primary Markets: - Australia (au), Austria (at), Belgium (be), Canada (ca), Switzerland (ch) - Germany (de), Spain (es), France (fr), Hong Kong (hk), Ireland (ie) - Italy (it), Malaysia (my), Netherlands (nl), New Zealand (nz), Philippines (ph) - Poland (pl), Singapore (sg), United Kingdom (uk), United States (us/usa) Additional Markets: - Argentina (ar), Brazil (br), China (cn), Colombia (co), Czech Republic (cz) - Denmark (dk), Finland (fi), Greece (gr), Hungary (hu), Indonesia (id) - Israel (il), India (in), Japan (jp), South Korea (kr), Mexico (mx) - Norway (no), Sweden (se), Thailand (th), Taiwan (tw), Vietnam (vn) ## Input Example json { "productUrl": "https://www.ebay.com/itm/205058935827", "countryIso": "us", "page": 1, "perPage": 25 } ## Output Format The actor returns a JSON object containing: ### Statistics Object - totalFeedback: Total number of feedback items - revisedFeedback: Number of revised feedback items ### Feedback Items Array Each feedback item contains: | Field | Type | Description | |-------|------|-------------| | id | string | Unique feedback ID | | rating | string | Rating type (e.g., "POSITIVE", "NEGATIVE", "NEUTRAL") | | buyerUsername | string | Anonymized buyer username | | buyerScore | integer | Buyer's feedback score | | timeFrame | string | When the review was posted | | itemPrice | string | Price of the item at time of purchase | | itemName | string | Name of the purchased item | | itemId | string | eBay item ID | | comment | string | Review comment text | | verifiedPurchase | boolean | Whether the purchase is verified | ## Output Example json { "stats": { "totalFeedback": 15, "revisedFeedback": 114 }, "feedbackItems": [ { "id": "2405414636015", "rating": "POSITIVE", "buyerUsername": "4***4", "buyerScore": 1, "timeFrame": "Últimos 6 meses", "itemPrice": "EUR 309,99", "itemName": "Samsung Galaxy Tab S7+ T970 WiFi 256GB Black Android Tablet gut", "itemId": "205058935827", "comment": "Wie neue , funktioniert perfekt alles ist gut danke. Ich empfehle euch 😉", "verifiedPurchase": true }, { "id": "2402863224015", "rating": "POSITIVE", "buyerUsername": "i***i", "buyerScore": 24, "timeFrame": "Últimos 6 meses", "itemPrice": "EUR 309,99", "itemName": "Samsung Galaxy Tab S7+ T970 WiFi 256GB Black Android Tablet gut", "itemId": "205058935827", "comment": "The seller was kind enough to provide me with help when needed i recommend thanks", "verifiedPurchase": true } ] } ## Usage Instructions ### 1. Basic Usage To scrape reviews from a single eBay product: json { "productUrl": "https://www.ebay.com/itm/YOUR_ITEM_ID" } ### 2. Multi-Region Scraping To scrape reviews from eBay Germany: json { "productUrl": "https://www.ebay.de/itm/YOUR_ITEM_ID", "countryIso": "de" } ### 3. Pagination To get reviews from page 2 with 50 reviews per page: json { "productUrl": "https://www.ebay.com/itm/YOUR_ITEM_ID", "page": 2, "perPage": 50 } ## API Integration ### Using Apify API javascript const ApifyClient = require('apify-client'); const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN', }); const input = { productUrl: "https://www.ebay.com/itm/205058935827", countryIso: "us", page: 1, perPage: 25 }; const run = await client.actor('THE_ACTOR_ID').call(input); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ### Using REST API bash curl -X POST https://api.apify.com/v2/acts/THE_ACTOR_ID/runs \ -H "Authorization: Bearer YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "productUrl": "https://www.ebay.com/itm/205058935827", "countryIso": "us", "page": 1, "perPage": 25 }' ## Rate Limits and Best Practices 1. Respectful Scraping: The actor implements appropriate delays to avoid overwhelming eBay's servers 2. Error Handling: Built-in error handling for network issues and parsing errors 3. Data Storage: Results are automatically stored in Apify datasets for easy retrieval 4. Pagination: Use pagination parameters to collect large datasets efficiently ## Common Use Cases ### Market Research - Analyze customer sentiment for competitor products - Identify common complaints and praise points - Track product reputation over time ### Product Development - Gather feedback on product features - Understand customer pain points - Validate product improvements ### Seller Insights - Monitor customer satisfaction - Identify areas for customer service improvement - Track feedback trends ## Troubleshooting ### Common Issues 1. Invalid Product URL: Ensure the URL is a valid eBay product page 2. Country Mismatch: Make sure the country ISO code matches the eBay domain 3. No Reviews Found: Some products may not have reviews or reviews may not be publicly visible 4. Rate Limiting: If you encounter rate limits, try reducing the frequency of requests ### Error Messages - "Invalid product URL": Check that the URL is correctly formatted and accessible - "No reviews found": The product may not have any reviews or they may be hidden - "Country not supported": Verify the country ISO code is in the supported list ## Support and Updates This actor is maintained and regularly updated to handle changes in eBay's website structure. For support or feature requests, please contact the actor maintainer through the Apify platform. ## Data Privacy and Compliance This actor only collects publicly available review data from eBay. All personal information is anonymized (usernames are masked) to protect user privacy. Please ensure compliance with your local data protection regulations when using this tool. ## Pricing The actor's usage is billed according to Apify's standard pricing model based on compute units consumed. Factors affecting cost include: - Number of reviews scraped - Frequency of requests - Data processing complexity For current pricing information, please refer to your Apify dashboard or contact Apify support. --- ## 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. ---