# eBay Product Reviews

Reviews of an eBay catalog product by ePID (the number in eBay /p/<epid> links): average rating, ratings count, star histogram, feature ratings, and 10 reviews per page with rating, author, date, title, text, verified purchase, condition, seller and helpful votes. Sort by newest, relevant, highest or lowest. The rating filter is computed by Scrappa from the star histogram (eBay has no star filter), so it reads up to 12 pages upstream. A page past the last returns an empty page. Costs 1 credit. Typical latency 2 to 8 seconds, 6 to 17 seconds with the rating filter. Marketplace: ebay.com.

- **Documentation:** [https://scrappa.co/docs/ebay-api/ebay_product_reviews](https://scrappa.co/docs/ebay-api/ebay_product_reviews)
- **API group:** eBay API
- **Endpoint:** `GET https://scrappa.co/api/ebay/product/reviews`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `epid` | string | Yes | eBay catalog product id, e.g. 24036417219. |
| `page` | integer | No | Review page, 1-based. Default: 1. |
| `sort` | string | No | newest (default), relevant, highest or lowest. |
| `rating` | integer | No | Only reviews with this star rating, 1 to 5. Cannot be combined with sort. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/ebay/product/reviews?epid=24036417219&page=1"
```

## Example response

```json
{
    "success": true,
    "data": {
        "epid": "24036417219",
        "page": 1,
        "per_page": 10,
        "has_next": true,
        "average_rating": 4.8,
        "ratings_count": 89,
        "reviews_count": 82,
        "rating_histogram": {
            "5": 78,
            "4": 5,
            "3": 4,
            "2": 0,
            "1": 2
        },
        "reviews": [
            {
                "id": "10000000337364246",
                "rating": 5,
                "author": "pleonetti",
                "date": "Sep 19, 2026",
                "title": "Like new. 2 months in and works great!",
                "body": "Like new. 2 months in and works great!",
                "verified_purchase": true,
                "condition": "refurbished",
                "helpful_votes": 0
            }
        ]
    },
    "meta": {
        "endpoint_family": "product_reviews"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | eBay has no result for this request. This response is not billable. |  |
|  | A public parameter is invalid. This response is not billable. |  |
|  | eBay did not return usable data for this request. This response is not billable. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)