nvNeuralVerge
E-commerce & Marketplaces

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.

Example response
{
  "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.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Reading reviews by handOpen the product page and scroll through reviewsFree, and slow beyond a handful of productsFine for spot-checking one product, not a category
Building a scraperWrite it, host it, repair it when eBay's page markup changesEngineering timeA maintenance commitment for something that isn't your product
NeuralVergeOne request per product, review count as a parameter$1 per 1,000 returned resultsReturns what's published — a snapshot of self-selected opinion, not a market truth
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
idstringeBay's internal ID for the review.
ratingnumberStar rating the reviewer gave, 1-5.
textstringReview text.
authorstringDisplay name of the buyer who left the review.
created_atstringDate the review was posted, as eBay displays it, e.g. "May 31, 2024".
created_datestringMachine-readable review date, when eBay publishes one.
is_verifiedbooleanWhether eBay marks the review as a verified purchase.
conditionstringCondition the reviewer bought, when eBay records one.
sold_bystringSeller username the reviewer bought from, when eBay records one.
helpful_countnumberNumber of buyers who marked the review as helpful.
is_top_favorablebooleanWhether eBay surfaces this as a top favorable review.
is_top_criticalbooleanWhether eBay surfaces this as a top critical review.
Integration

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 }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Voice-of-customer research

Mine the exact language buyers use about a product you're sourcing or competing with.

Quality monitoring

Watch a product's review stream for a spike in complaints about a specific defect.

Competitive comparison

Compare review sentiment across a few competing products under the same category.

Listing decisions

Check whether a product has a track record of buyer complaints before deciding to list or resell it.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

eBay catalog products with published buyer reviews.

Freshness

Read at request time.

Handling

This source returns publicly visible review information, stamped with the ePID or URL it was read from and a session id you can trace.

What it will not do
  • —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.
FAQ

Questions, answered

The whole catalog product — reviews aren't tied to a specific seller's listing.

Related

Related sources

Try ebay product reviews on your own data

One request format across every source in the catalog.

Get started