> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Item Reviews
> Catalog product reviews shown on an eBay listing, with rating summary and histogram.
## Path Parameters
The eBay listing item id whose catalog product reviews you want.
## Query Parameters
eBay marketplace domain where the listing lives.
Examples: `com`, `co.uk`, `de`, `fr`
Page number for paginated reviews. Range: `1` - `50`.
## Response
Marketplace domain the reviews were fetched from.
The item id the reviews were requested for (nullable).
The eBay catalog product id the reviews belong to (nullable).
Average star rating across all reviews (0-5, nullable).
Total number of ratings (nullable).
Star-bucket counts.
Number of 5-star reviews (nullable).
Number of 4-star reviews (nullable).
Number of 3-star reviews (nullable).
Number of 2-star reviews (nullable).
Number of 1-star reviews (nullable).
Array of reviews.
Review title (nullable).
Review body text (nullable).
Star rating for this review (0-5, nullable).
Reviewer display name (nullable).
Raw date string as shown on eBay (nullable).
ISO 8601 review date (nullable).
Number of helpful votes (nullable).
Whether the review is from a verified purchase.
Pagination metadata with `current_page`, `per_page`, `total_pages`, `total_results`.
ISO 8601 timestamp when the reviews were scraped.
### Example Response
```json theme={null}
{
"domain": "com",
"item_id": "256123456789",
"product_id": "20057872541",
"rating": 4.8,
"ratings_total": 1245,
"histogram": { "five_star": 1050, "four_star": 120, "three_star": 40, "two_star": 20, "one_star": 15 },
"reviews": [
{
"title": "Excellent console",
"body": "Screen is gorgeous and the build quality is great.",
"rating": 5.0,
"author": "gamer_dad",
"date_raw": "May 12, 2026",
"date_at": "2026-05-12T00:00:00Z",
"helpful_votes": 23,
"verified_purchase": true
}
],
"pagination": { "current_page": 1, "per_page": 20, "total_pages": 50, "total_results": 1245 },
"scraped_at": "2026-06-21T12:00:00Z"
}
```
Each item-reviews request costs **10 credits**. Failed requests are not charged.
## OpenAPI
````yaml GET /v1/ebay/items/{item_id}/reviews
openapi: 3.1.0
info:
title: ScrapeBadger eBay API
version: 1.0.0
description: >-
eBay marketplace scraping API for searching active and completed (sold)
listings, fetching item details, reviews, sellers, seller listings and
feedback, category browsing, autocomplete, and reference data across 18
marketplaces.
servers:
- url: https://scrapebadger.com
description: Production
security:
- apiKeyAuth: []
paths:
/v1/ebay/items/{item_id}/reviews:
get:
tags:
- eBay Items
summary: Get Item Reviews
description: Get catalog product reviews shown on an eBay listing.
operationId: getEbayItemReviews
parameters:
- name: item_id
in: path
required: true
schema:
type: string
description: The eBay listing item id.
- name: domain
in: query
schema:
type: string
default: com
description: eBay marketplace domain TLD or alias (com, co.uk, de, fr, ...).
- name: page
in: query
schema:
type: integer
default: 1
minimum: 1
maximum: 50
description: Page number for reviews.
responses:
'200':
description: Reviews
content:
application/json:
schema:
type: object
properties:
domain:
type: string
item_id:
type:
- string
- 'null'
product_id:
type:
- string
- 'null'
rating:
type:
- number
- 'null'
ratings_total:
type:
- integer
- 'null'
histogram:
type: object
properties:
five_star:
type:
- integer
- 'null'
four_star:
type:
- integer
- 'null'
three_star:
type:
- integer
- 'null'
two_star:
type:
- integer
- 'null'
one_star:
type:
- integer
- 'null'
reviews:
type: array
items:
type: object
properties:
title:
type:
- string
- 'null'
body:
type:
- string
- 'null'
rating:
type:
- number
- 'null'
author:
type:
- string
- 'null'
date_raw:
type:
- string
- 'null'
date_utc:
type:
- number
- 'null'
date_at:
type:
- string
- 'null'
helpful_votes:
type:
- integer
- 'null'
verified_purchase:
type: boolean
pagination:
type: object
properties:
current_page:
type: integer
per_page:
type:
- integer
- 'null'
total_pages:
type:
- integer
- 'null'
total_results:
type:
- integer
- 'null'
scraped_utc:
type:
- number
- 'null'
scraped_at:
type:
- string
- 'null'
components:
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
````