eBay Store Reviews Actor

Overview

The eBay Store Reviews Actor is a powerful web scraping tool designed to extract customer reviews and feedback from eBay stores across multiple international markets. This actor provides comprehensive access to store feedback data, including ratings, comments, buyer information, and purchase details.

Features

• Multi-Country Support: Extract reviews from 30+ eBay regional sites
• Pagination Control: Navigate through multiple pages of reviews
• Flexible Results Limit: Control the number of reviews per page (24, 48, or 72)
• Detailed Feedback Data: Get comprehensive review information including ratings, comments, and buyer details
• Verified Purchase Detection: Identify reviews from verified purchases
• Statistics Summary: Get overview statistics including total feedback count

Supported Countries

The actor supports eBay sites from the following countries:

Primary Markets:

• United States (us, usa)
• United Kingdom (uk)
• Germany (de)
• France (fr)
• Canada (ca)
• Australia (au)

European Markets:

• Austria (at), Belgium (be), Switzerland (ch), Spain (es), Ireland (ie), Italy (it), Netherlands (nl), Poland (pl), Czech Republic (cz), Denmark (dk), Finland (fi), Greece (gr), Hungary (hu), Norway (no), Sweden (se)

Asian Markets:

• Hong Kong (hk), Malaysia (my), Philippines (ph), Singapore (sg), China (cn), India (in), Japan (jp), South Korea (kr), Thailand (th), Taiwan (tw), Vietnam (vn), Indonesia (id)

Other Markets:

• New Zealand (nz), Argentina (ar), Brazil (br), Colombia (co), Israel (il), Mexico (mx)

Input Parameters

Required Parameters

Parameter	Type	Description
storeUrl	string	The complete eBay store URL to scrape reviews from

Optional Parameters

Parameter	Type	Default	Description
countryIso	string	"us"	Two-letter ISO country code for the eBay regional site
page	integer	1	Page number for pagination (minimum: 1)
perPage	string	"24"	Number of reviews per page (options: "24", "48", "72")

Input Schema Example

{
  "storeUrl": "https://www.ebay.com/str/lovellrugby?_trksid=p4429486.m3561.l161211",
  "countryIso": "us",
  "page": 1,
  "perPage": "24"
}

Output Structure

The actor returns a JSON object containing feedback statistics and detailed review items.

Output Schema

{
  "stats": {
    "totalFeedback": "number",
    "revisedFeedback": "number"
  },
  "feedbackItems": [
    {
      "id": "string",
      "rating": "string",
      "buyerUsername": "string",
      "buyerScore": "number",
      "timeFrame": "string",
      "itemPrice": "string",
      "itemName": "string",
      "itemId": "string",
      "comment": "string",
      "verifiedPurchase": "boolean"
    }
  ]
}

Field Descriptions

Stats Object

• totalFeedback: Total number of feedback reviews for the store
• revisedFeedback: Number of revised feedback entries

Feedback Items Array

• id: Unique identifier for the feedback entry
• rating: Rating type (e.g., "POSITIVE", "NEGATIVE", "NEUTRAL")
• buyerUsername: Anonymized username of the buyer (e.g., "n***i")
• buyerScore: Buyer's feedback score on eBay
• timeFrame: Time period when the review was left (localized)
• itemPrice: Price of the purchased item
• itemName: Full name and description of the purchased item
• itemId: eBay item identifier (if available)
• comment: Buyer's written review/comment
• verifiedPurchase: Boolean indicating if this was a verified purchase

Usage Examples

Basic Usage

Extract reviews from a US eBay store with default settings:

{
  "storeUrl": "https://www.ebay.com/str/lovellrugby?_trksid=p4429486.m3561.l161211"
}

Advanced Usage

Extract reviews from a German eBay store, page 2, with 48 reviews per page:

{
  "storeUrl": "https://www.ebay.de/str/electronics-store",
  "countryIso": "de",
  "page": 2,
  "perPage": "48"
}

Pagination Example

To scrape multiple pages of reviews, run the actor multiple times with different page numbers:

{
  "storeUrl": "https://www.ebay.co.uk/str/fashion-store",
  "countryIso": "uk",
  "page": 1,
  "perPage": "72"
}

Best Practices

Rate Limiting

• Use reasonable delays between requests to avoid being blocked
• Consider the target eBay site's terms of service
• Monitor your requests to avoid overloading the servers

Data Processing

• Store results incrementally using the pagination feature
• Filter results based on rating, time frame, or verified purchases as needed
• Consider the localized nature of time frames and prices

Error Handling

• Validate store URLs before processing
• Handle cases where stores have no reviews
• Account for regional differences in eBay site structures

Common Use Cases

Market Research

• Analyze competitor store feedback patterns
• Identify common customer complaints or praise points
• Track feedback trends over time

Seller Analysis

• Monitor your own store's review performance
• Identify areas for improvement based on customer feedback
• Track changes in customer satisfaction

Product Research

• Analyze reviews for specific product categories
• Identify popular products based on review frequency
• Research pricing strategies from successful sellers

Limitations

• Reviews are subject to eBay's display policies and may be filtered
• Anonymous usernames protect buyer privacy
• Some older reviews may have limited information
• Regional sites may have different data availability

Error Handling

The actor includes comprehensive error handling:

• Invalid URLs: The actor will log an error if the store URL is malformed
• Network Issues: Automatic retry logic for temporary connection problems
• Data Parsing: Graceful handling of unexpected page structures
• Rate Limiting: Built-in delays to prevent being blocked

Technical Details

Dependencies

• Apify SDK: Core framework for the actor
• Axios: HTTP client for making requests
• Custom Helpers: Specialized functions for eBay data extraction

Performance

• Optimized for processing large numbers of reviews
• Efficient pagination handling
• Memory-conscious data storage

Data Storage

• Results are stored using Actor.pushData() for incremental processing
• Final output is saved using Actor.setValue() for easy retrieval
• Compatible with Apify's dataset and key-value store systems

Support and Maintenance

This actor is actively maintained and updated to handle changes in eBay's website structure. For issues or feature requests, please refer to the actor's documentation on the Apify platform.

---

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.

---