eBay Product Reviews API — Buyer Reviews by ePID
Send an eBay catalog product's ePID or URL and this source returns the buyer reviews left on that catalog product, one row per review.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "ebay_product_reviews",
"product": "28032667767",
"max_items": 2,
"start_page": 1,
"human": "# eBay product reviews\n\n- **Product:** 28032667767\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 481.5 KB",
"machine": {
"total_items": 2,
"reviews": [
{
"id": "10000000318520591",
"rating": 5,
"text": "Fantastic item! Mouse works perfectly. It is better for my wrist than the one I had. Did not realize how much of an angle my hand was at all day. This — Fantastic item! Mouse works perfectly. It is better for my wrist than the one I had. Did not realize how much of an angle my hand was at all day. This mouse is accurate and I love the features on it. Thank you",
"author": "jrstufff",
"created_at": "May 31, 2024",
"created_date": null,
"is_verified": true,
"condition": null,
"sold_by": "onlyonedeal",
"helpful_count": 0,
"is_top_favorable": false,
"is_top_critical": false
},
{
"id": "10000000283857118",
"rating": 1,
"text": "Must have a unifying receiver to use this wireless mouse. — Received the mouse and was excited to put it to work. Found out none of my existing usb receivers were compatible. Tried multiple combinations on my three other M705 mice and none of them are interchangeable. Only the receiver that came with the original mouse worked. Sorry this didn't work out. Had high hopes.",
"author": "pw923941kpx",
"created_at": "Mar 31, 2020",
"created_date": null,
"is_verified": true,
"condition": "Pre-Owned",
"sold_by": "voltage_electro...",
"helpful_count": 0,
"is_top_favorable": false,
"is_top_critical": false
}
],
"proxy_traffic_bytes": 493088
},
"total_points": 2
}- You send
- An eBay ePID or product URL, plus how many reviews to return
- You get back
- Buyer reviews for the catalog product
- Coverage
- eBay catalog products with published buyer reviews.
- Price
- 1 point per returned result, up to 500 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A product with no reviews costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Reading reviews by hand | Open the product page and scroll through reviews | Free, and slow beyond a handful of products | Fine for spot-checking one product, not a category |
| Building a scraper | Write it, host it, repair it when eBay's page markup changes | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request per product, review count as a parameter | $1 per 1,000 returned results | Returns what's published — a snapshot of self-selected opinion, not a market truth |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
id | string | eBay's internal ID for the review. |
rating | number | Star rating the reviewer gave, 1-5. |
text | string | Review text. |
author | string | Display name of the buyer who left the review. |
created_at | string | Date the review was posted, as eBay displays it, e.g. "May 31, 2024". |
created_date | string | Machine-readable review date, when eBay publishes one. |
is_verified | boolean | Whether eBay marks the review as a verified purchase. |
condition | string | Condition the reviewer bought, when eBay records one. |
sold_by | string | Seller username the reviewer bought from, when eBay records one. |
helpful_count | number | Number of buyers who marked the review as helpful. |
is_top_favorable | boolean | Whether eBay surfaces this as a top favorable review. |
is_top_critical | boolean | Whether eBay surfaces this as a top critical review. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
product is required; max_items caps results at 500 and defaults to 10. start_page pages through reviews beyond that cap.
curl -X POST https://api.neuralverge.ai/functions/v1/run-ebay-product-reviews \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "product": "28032667767", "max_items": 10 }'What teams use it for
Where this field shows up in an actual workflow.
Mine the exact language buyers use about a product you're sourcing or competing with.
Watch a product's review stream for a spike in complaints about a specific defect.
Compare review sentiment across a few competing products under the same category.
Check whether a product has a track record of buyer complaints before deciding to list or resell it.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
eBay catalog products with published buyer reviews.
Read at request time.
This source returns publicly visible review information, stamped with the ePID or URL it was read from and a session id you can trace.
- —Reviews are self-selected and skew toward strong opinions in both directions.
- —A product with few reviews returns a thin, less representative sample.
- —Reviews attach to the catalog product, so they reflect the product generally, not any one seller's shipping or service.
Questions, answered
The whole catalog product — reviews aren't tied to a specific seller's listing.
Related sources
Try ebay product reviews on your own data
One request format across every source in the catalog.