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

{
  "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

{
  "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:

{
  "productUrl": "https://www.ebay.com/itm/YOUR_ITEM_ID"
}

2. Multi-Region Scraping

To scrape reviews from eBay Germany:

{
  "productUrl": "https://www.ebay.de/itm/YOUR_ITEM_ID",
  "countryIso": "de"
}

3. Pagination

To get reviews from page 2 with 50 reviews per page:

{
  "productUrl": "https://www.ebay.com/itm/YOUR_ITEM_ID",
  "page": 2,
  "perPage": 50
}

API Integration

Using Apify API

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

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.

---