logo
languageENdown
menu

eBay Product Reviews

Give one eBay listing ID with site and an expected review count to receive public reviews, ratings, reviewer details, and publish times

Overview

Public eBay product reviews capture how buyers describe quality, defects, and disappointment in their own words. This Data App turns the public review area of one listing on the US, Australia, Canada, or UK site into a consistent set of records covering review titles, body text, star ratings, purchase verification, reviewer names, listing details, and publish times.

The result is built for repeatable reputation analysis instead of scrolling review pages. Each review keeps its original wording and stays linked to the listing, product, and seller identifiers, so praise and complaints can be compared across sites, sellers, and collection runs with the same fields.

Data notes

The data covers publicly visible eBay product reviews for the supplied listing ID and site at collection time. Each normal record is identified by its Comment ID, which removes duplicates across collected pages. Deleted, restricted, seller-feedback-only, and non-public reviews are outside the coverage. Listings on sites other than US, AU, CA, and UK are not covered.

Rating, Verified purchase, Cross-site review, vote counts, and listing details are snapshots and may change after collection. Comment type, Reviewed on, and Raw data retain source codes and the original payload. Published at and Collected at preserve the source timestamps without inferring a timezone. Source item and No data retain the collection outcome when a listing has no public review result.

What the results look like

Each normal record represents one publicly visible product review of the selected eBay listing.

Comment IDReview titleReview textRatingVerified purchasePublished at
10000000302170747Awsome thanks againThank you for this item beyond description5Yes2021-09-07T00:00:00
10000000305477500Insta360 One XGreat camera !!!5Yes2022-02-27T00:00:00

Additional values include Reviewer name, Item title, Seller name, vote counts, Raw data, and Review media.

Use cases

  • Split reviews by Rating, then read Review title and Review text to locate low-score issues.
  • Compare Verified purchase with Review text when judging how much weight to give a review.
  • Count Comment ID by Published at to see how the mix of feedback changed over time.
  • Read Review title alongside Rating to separate headline praise from detailed complaints.

Scope and boundaries

Each run accepts one eBay listing ID with site (US, AU, CA, or UK) and an expected review count from 1 to 10000. Results are returned and billed in complete batches of 10, so the actual count may be rounded up. Only publicly visible eBay product reviews are covered.

  • Good for
  • When you need public review text, titles, and star ratings for one eBay listing on the US, Australia, Canada, or UK site
  • When you need purchase verification, reviewer names, listing details, vote counts, and publish times for reputation analysis
  • Do not use for
  • When you need reviews from more than one listing in a single run — submit a separate run for each listing
  • When you need seller feedback rather than product reviews
  • When you need listings on sites other than US, AU, CA, or UK
  • When you need deleted, restricted, or non-public reviews

Failure handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

  1. 1If no reviews are returned, verify the listing ID and site suffix, and confirm that the product reviews are publicly visible
  2. 2Retry later after rate limiting, temporary service unavailability, or a timeout
  3. 3When the submission outcome is unknown, avoid immediate repeated submissions that could create duplicate tasks
  4. 4If authentication fails, verify the API Key configured for the execution environment
  5. 5If the task context does not match or the task has expired, submit a new collection instead of retrying the same task
  6. 6A partial success returns the reviews that were completed; the actual count may still differ from the expected value after batch rounding

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
itemItem ID and sitestringYes——114452409636-USThe eBay listing to collect public product reviews from. Enter one listing ID and site as <listingID>-<site>, where site is US, AU, CA, or UK, for example 114452409636-US.
comment_countExpected review countstringYes——1The expected number of reviews to collect, from 1 to 10000. Results are returned and billed in complete batches of 10, so the actual count may be rounded up, and fewer than 10 reviews still count as one batch.
order_typeReview sort orderstring(enum)No44 (Newest) / 8 (Most relevant) / 11 (Highest rating) / 12 (Lowest rating)—How the collected reviews are ordered. 4 is newest, 8 is most relevant, 11 is highest rating, and 12 is lowest rating. Default 4, which uses newest first.

Output

Field structure of a single record, generated from the output.schema in manifest.json.

FieldBusiness nameTypeExampleDescription
comment_idComment IDstring10000000302170747The stable unique identifier of the eBay product review
comment_typeComment typestring1The source code identifying the review type
country_codeCountry codestringUSThe country or region code associated with the review
crawl_timeCollected atstring2026-09-04T17:26:13The source timestamp when the review was collected
is_cross_site_reviewCross-site reviewbooleanfalseWhether the review was written on a different eBay site
is_verified_purchaseVerified purchasebooleantrueWhether the reviewer is marked as a verified purchaser
item_idListing IDstring154498378002The eBay listing identifier associated with the review
item_image_urlItem imagestringhttps://i.ebayimg.com/00/s/NTk3WDQ0OA==/z/fAkAAOSwr2NgzSLs/$_35.JPG?set_id=8800005007The public image URL of the reviewed listing
item_titleItem titlestringInsta360 ONE X 18MP 5.7K 360 Degree Action Camera FOR PARTSThe listing title associated with the review
origin_comment_idOriginal comment IDstring10000000302170747The original identifier of the source review
product_idProduct IDstring10026190245The eBay product identifier linked to the review
publish_timePublished atstring2021-09-07T00:00:00The source timestamp when the review was published
rating_scoreRatinginteger5The star rating given in the review
review_dataRaw datastring{"authorUserName": "juvinille_534", "createdByStr": "<span class=\"author-by\">评价人:</span> <a _sp=\"p2266119.m3960.l7039\" class=\"review-item-author\" href=\"https://www.ebay.com/usr/juvinille_534\" itemprop=\"author\" title=\"juvinille_534\">juvinille_534</a>", "creationDate": "2021-09-07", "description": "Thank you for this item beyond description", "isReviewWrittenOnDifferentSite": false, "isUserResportSpam": -9, "isVerifiedPurchase": true, "item": {"id": "154498378002", "imageURL": "https://i.ebayimg.com/00/s/NTk3WDQ0OA==/z/fAkAAOSwr2NgzSLs/$_35.JPG?set_id=8800005007", "listingClassification": {}, "sellerName": "phonesdeal", "seoTitle": "Insta360-ONE-X-18MP-5-7K-360-Degree-Action-Camera-FOR-PARTS", "title": "Insta360 ONE X 18MP 5.7K 360 Degree Action Camera FOR PARTS", "variationId": "", "viewSellerName": "phonesdeal"}, "lastModifiedDate": "2021-09-07", "productId": "10026190245", "rating": 5, "ratingCountStr": "5 个评分", "reviewId": "10000000302170747", "reviewRecommendation": 0, "reviewedOn": "EBAY_US", "siteUrl": "", "title": "Awsome thanks again", "votesNegative": 0, "votesPositive": 0, "votesTotal": 0}The complete original collection payload for the review and listing
review_mediaReview mediastring—The review media information retained in the source text form
review_textReview textstringThank you for this item beyond descriptionThe review body published by the buyer
review_titleReview titlestringAwsome thanks againThe review title published by the buyer
reviewed_onReviewed onstringEBAY_USThe eBay site code where the review was recorded
reviewer_nameReviewer namestringjuvinille_534The public display name of the reviewer
seller_nameSeller namestringphonesdealThe public seller name of the reviewed listing
sku_idItem ID and sitestring114452409636-USThe listing ID and site submitted for this review record
votes_negativeDownvotesinteger0The number of negative votes recorded for the review
votes_positiveUpvotesinteger0The number of positive votes recorded for the review
votes_totalTotal votesinteger0The total number of votes recorded for the review
source_itemSource itemstring114452409636-USThe listing ID and site submitted for this collection run
no_dataNo databooleanfalseWhether this collection run found no public review result for the listing

Record schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "comment_id": {
      "type": "string",
      "title": "Comment ID",
      "description": "The stable unique identifier of the eBay product review",
      "prefill": "10000000302170747"
    },
    "comment_type": {
      "type": "string",
      "title": "Comment type",
      "description": "The source code identifying the review type",
      "prefill": "1"
    },
    "country_code": {
      "type": "string",
      "title": "Country code",
      "description": "The country or region code associated with the review",
      "prefill": "US"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collected at",
      "description": "The source timestamp when the review was collected",
      "prefill": "2026-09-04T17:26:13"
    },
    "is_cross_site_review": {
      "type": "boolean",
      "title": "Cross-site review",
      "description": "Whether the review was written on a different eBay site",
      "prefill": false
    },
    "is_verified_purchase": {
      "type": "boolean",
      "title": "Verified purchase",
      "description": "Whether the reviewer is marked as a verified purchaser",
      "prefill": true
    },
    "item_id": {
      "type": "string",
      "title": "Listing ID",
      "description": "The eBay listing identifier associated with the review",
      "prefill": "154498378002"
    },
    "item_image_url": {
      "type": "string",
      "title": "Item image",
      "description": "The public image URL of the reviewed listing",
      "prefill": "https://i.ebayimg.com/00/s/NTk3WDQ0OA==/z/fAkAAOSwr2NgzSLs/$_35.JPG?set_id=8800005007"
    },
    "item_title": {
      "type": "string",
      "title": "Item title",
      "description": "The listing title associated with the review",
      "prefill": "Insta360 ONE X 18MP 5.7K 360 Degree Action Camera FOR PARTS"
    },
    "origin_comment_id": {
      "type": "string",
      "title": "Original comment ID",
      "description": "The original identifier of the source review",
      "prefill": "10000000302170747"
    },
    "product_id": {
      "type": "string",
      "title": "Product ID",
      "description": "The eBay product identifier linked to the review",
      "prefill": "10026190245"
    },
    "publish_time": {
      "type": "string",
      "title": "Published at",
      "description": "The source timestamp when the review was published",
      "prefill": "2021-09-07T00:00:00"
    },
    "rating_score": {
      "type": "integer",
      "title": "Rating",
      "description": "The star rating given in the review",
      "prefill": 5
    },
    "review_data": {
      "type": "string",
      "title": "Raw data",
      "description": "The complete original collection payload for the review and listing",
      "prefill": "{\"authorUserName\": \"juvinille_534\", \"createdByStr\": \"<span class=\\\"author-by\\\">评价人:</span> <a _sp=\\\"p2266119.m3960.l7039\\\" class=\\\"review-item-author\\\" href=\\\"https://www.ebay.com/usr/juvinille_534\\\" itemprop=\\\"author\\\" title=\\\"juvinille_534\\\">juvinille_534</a>\", \"creationDate\": \"2021-09-07\", \"description\": \"Thank you for this item beyond description\", \"isReviewWrittenOnDifferentSite\": false, \"isUserResportSpam\": -9, \"isVerifiedPurchase\": true, \"item\": {\"id\": \"154498378002\", \"imageURL\": \"https://i.ebayimg.com/00/s/NTk3WDQ0OA==/z/fAkAAOSwr2NgzSLs/$_35.JPG?set_id=8800005007\", \"listingClassification\": {}, \"sellerName\": \"phonesdeal\", \"seoTitle\": \"Insta360-ONE-X-18MP-5-7K-360-Degree-Action-Camera-FOR-PARTS\", \"title\": \"Insta360 ONE X 18MP 5.7K 360 Degree Action Camera FOR PARTS\", \"variationId\": \"\", \"viewSellerName\": \"phonesdeal\"}, \"lastModifiedDate\": \"2021-09-07\", \"productId\": \"10026190245\", \"rating\": 5, \"ratingCountStr\": \"5 个评分\", \"reviewId\": \"10000000302170747\", \"reviewRecommendation\": 0, \"reviewedOn\": \"EBAY_US\", \"siteUrl\": \"\", \"title\": \"Awsome thanks again\", \"votesNegative\": 0, \"votesPositive\": 0, \"votesTotal\": 0}"
    },
    "review_media": {
      "type": "string",
      "title": "Review media",
      "description": "The review media information retained in the source text form"
    },
    "review_text": {
      "type": "string",
      "title": "Review text",
      "description": "The review body published by the buyer",
      "prefill": "Thank you for this item beyond description"
    },
    "review_title": {
      "type": "string",
      "title": "Review title",
      "description": "The review title published by the buyer",
      "prefill": "Awsome thanks again"
    },
    "reviewed_on": {
      "type": "string",
      "title": "Reviewed on",
      "description": "The eBay site code where the review was recorded",
      "prefill": "EBAY_US"
    },
    "reviewer_name": {
      "type": "string",
      "title": "Reviewer name",
      "description": "The public display name of the reviewer",
      "prefill": "juvinille_534"
    },
    "seller_name": {
      "type": "string",
      "title": "Seller name",
      "description": "The public seller name of the reviewed listing",
      "prefill": "phonesdeal"
    },
    "sku_id": {
      "type": "string",
      "title": "Item ID and site",
      "description": "The listing ID and site submitted for this review record",
      "prefill": "114452409636-US"
    },
    "votes_negative": {
      "type": "integer",
      "title": "Downvotes",
      "description": "The number of negative votes recorded for the review",
      "prefill": 0
    },
    "votes_positive": {
      "type": "integer",
      "title": "Upvotes",
      "description": "The number of positive votes recorded for the review",
      "prefill": 0
    },
    "votes_total": {
      "type": "integer",
      "title": "Total votes",
      "description": "The total number of votes recorded for the review",
      "prefill": 0
    },
    "source_item": {
      "type": "string",
      "title": "Source item",
      "description": "The listing ID and site submitted for this collection run",
      "prefill": "114452409636-US"
    },
    "no_data": {
      "type": "boolean",
      "title": "No data",
      "description": "Whether this collection run found no public review result for the listing",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "hello_moto__ebay-product-comment": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/ebay-product-comment",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

10 returned reviews

Charged by the number of records successfully returned. Failed runs are not charged. Billed in units of 10 record; any partial unit is rounded up to 10 record.

$0.004/ 10 record
Per task submitted

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
From $0.004 / 10 record