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 ID | Review title | Review text | Rating | Verified purchase | Published at |
|---|---|---|---|---|---|
| 10000000302170747 | Awsome thanks again | Thank you for this item beyond description | 5 | Yes | 2021-09-07T00:00:00 |
| 10000000305477500 | Insta360 One X | Great camera !!! | 5 | Yes | 2022-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.
- 1If no reviews are returned, verify the listing ID and site suffix, and confirm that the product reviews are publicly visible
- 2Retry later after rate limiting, temporary service unavailability, or a timeout
- 3When the submission outcome is unknown, avoid immediate repeated submissions that could create duplicate tasks
- 4If authentication fails, verify the API Key configured for the execution environment
- 5If the task context does not match or the task has expired, submit a new collection instead of retrying the same task
- 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.
| Field | Business name | Type | Required | Default | Enum / Constraints | Example | Description |
|---|---|---|---|---|---|---|---|
| item | Item ID and site | string | Yes | — | — | 114452409636-US | The 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_count | Expected review count | string | Yes | — | — | 1 | The 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_type | Review sort order | string(enum) | No | 4 | 4 (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.
| Field | Business name | Type | Example | Description |
|---|---|---|---|---|
| comment_id | Comment ID | string | 10000000302170747 | The stable unique identifier of the eBay product review |
| comment_type | Comment type | string | 1 | The source code identifying the review type |
| country_code | Country code | string | US | The country or region code associated with the review |
| crawl_time | Collected at | string | 2026-09-04T17:26:13 | The source timestamp when the review was collected |
| is_cross_site_review | Cross-site review | boolean | false | Whether the review was written on a different eBay site |
| is_verified_purchase | Verified purchase | boolean | true | Whether the reviewer is marked as a verified purchaser |
| item_id | Listing ID | string | 154498378002 | The eBay listing identifier associated with the review |
| item_image_url | Item image | string | https://i.ebayimg.com/00/s/NTk3WDQ0OA==/z/fAkAAOSwr2NgzSLs/$_35.JPG?set_id=8800005007 | The public image URL of the reviewed listing |
| item_title | Item title | string | Insta360 ONE X 18MP 5.7K 360 Degree Action Camera FOR PARTS | The listing title associated with the review |
| origin_comment_id | Original comment ID | string | 10000000302170747 | The original identifier of the source review |
| product_id | Product ID | string | 10026190245 | The eBay product identifier linked to the review |
| publish_time | Published at | string | 2021-09-07T00:00:00 | The source timestamp when the review was published |
| rating_score | Rating | integer | 5 | The star rating given in the review |
| review_data | Raw data | string | {"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_media | Review media | string | — | The review media information retained in the source text form |
| review_text | Review text | string | Thank you for this item beyond description | The review body published by the buyer |
| review_title | Review title | string | Awsome thanks again | The review title published by the buyer |
| reviewed_on | Reviewed on | string | EBAY_US | The eBay site code where the review was recorded |
| reviewer_name | Reviewer name | string | juvinille_534 | The public display name of the reviewer |
| seller_name | Seller name | string | phonesdeal | The public seller name of the reviewed listing |
| sku_id | Item ID and site | string | 114452409636-US | The listing ID and site submitted for this review record |
| votes_negative | Downvotes | integer | 0 | The number of negative votes recorded for the review |
| votes_positive | Upvotes | integer | 0 | The number of positive votes recorded for the review |
| votes_total | Total votes | integer | 0 | The total number of votes recorded for the review |
| source_item | Source item | string | 114452409636-US | The listing ID and site submitted for this collection run |
| no_data | No data | boolean | false | Whether this collection run found no public review result for the listing |
Record schema
Output is returned record by record. detail.output.idFieldHint
{
"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": {
"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
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.
Charged once per submitted run, regardless of how many records are returned.
Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.
View creditsTry it now
Fill in the parameters and run. Results come from a real call.