> For the complete documentation index, see [llms.txt](https://easyparser.gitbook.io/easyparser-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/seller-feedback/response.md). # Response The SELLER FEEDBACK operation returns a structured JSON response designed to provide clear visibility into a merchant's service history. The response is divided into metadata regarding your account's credit usage and the high-fidelity feedback data extracted from Amazon. ## API Response Structure Overview The root of the JSON response contains four primary objects that categorize the data. 1. **`request_info`:** Contains the request ID, success status, and credit consumption details. 2. **`request_parameters`**: Echoes the parameters sent in your request (e.g., `seller_id`, `rating_range`). 3. **`request_metadata`:** Provides timestamps for when the request was created and processed. 4. **`result`:** The main payload containing the `seller_feedback` array and `pagination` data. These fields provide essential information about the transaction status, parameters, and processing timing. ## 1. Top Level Meta Fields (Outside of result) These fields provide the technical context of your transaction, essential for debugging and monitoring account limits. ### request\_info (Object) The `request_info` object provides the technical status of your API call and real-time updates on your credit usage. | Field | Type | Description | | -------------------------- | ------- | -------------------------------------------------------------------- | | `id` | String | The unique identifier for this specific API request. | | `success` | Boolean | Indicates if the request was completed successfully. | | `status_code` | Integer | The standard HTTP response status (e.g., `200`). | | `credits_used` | Integer | Total credits consumed by your account so far in the current period. | | `credit_used_this_request` | Integer | The number of credits deducted for this specific operation. | | `credits_remaining` | Integer | Your remaining credit balance. | | `credits_reset_at` | String | The timestamp for when your credit quota will reset. | ### request\_parameters (Object) This object confirms the configuration used for the extraction, allowing you to verify that filters like rating and history were applied correctly. | Field | Type | Description | | --------------- | ------- | --------------------------------------------------------- | | `seller_id` | String | The target seller's identifier. | | `min_rating` | Integer | The minimum star rating requested. | | `max_rating` | Integer | The maximum star rating requested. | | `history_range` | String | The selected time range (e.g., `1`, `3`, `12`, or `all`). | ### request\_metadata (Object) The `request_metadata` object provides high-precision timestamps for the lifecycle of your request. This is particularly useful for auditing and calculating the total turnaround time of the data extraction. | Field | Type | Description | | ------------------ | ------ | ----------------------------------------------------- | | `created_at` | String | The exact timestamp when the request was received. | | `processed_at` | String | The timestamp when the data extraction was completed. | | `total_time_taken` | Float | Duration in seconds to complete the entire operation. | ## 2. Core Payload (Inside result) The `result` object is the most critical part of the response, containing the data harvested from the Amazon seller feedback pages. ### seller\_feedback (Array) This array contains the individual feedback entries. Each object represents a unique customer review of the seller. | Field | Type | Description | | -------------- | ------- | -------------------------------------------------------------------------- | | `body` | String | The actual comment or review text left by the customer. | | `rating` | Integer | The star rating assigned to the seller (1-5). | | `rater` | String | The display name of the customer. | | `has_response` | Boolean | Indicates if the seller has officially replied to this feedback. | | `date` | Object | Contains `raw` (text) and `timestamp` (Unix) formats of the feedback date. | | `profile` | Object | Includes the customer's `avatar` image and their Amazon profile `url`. | ### pagination (Array) The pagination object provides the necessary metadata to crawl through multiple pages of feedback data. | Field | Type | Description | | --------------- | ------- | ------------------------------------------------------------------- | | `current_page` | Integer | The page number of the current results. | | `has_next_page` | Boolean | If `true`, more results are available for extraction. | | `next_page` | Integer | The index to use for the `min_page` parameter in your next request. | ### Sample JSON Output {% code overflow="wrap" %} ```json { "request_info": { "id": "972efb5f-3e08-4ae0-bde2-705f99e68797", "success": true, "status_code": 200, "error_details": [], "credits_used": 11, "credit_used_this_request": 2, "credits_remaining": 14989, "credits_reset_at": "2026-06-19T20:37:38.000Z", "address": { "city": null, "district": null, "country_code": null, "zipCode": ["19805"] } }, "request_parameters": { "output": "json", "language": "en_US", "include_html": false, "seller_id": "A1MCYUGJD2ILFU", "max_rating": 5, "min_rating": 1, "history_range": "all", "type": "SELLER_FEEDBACK", "max_page": 2 }, "request_metadata": { "created_at": "2026-04-26T21:52:30.294Z", "processed_at": "2026-04-26T21:52:31.145Z", "total_time_taken": 0.851 }, "result": { "seller_feedback": [ { "body": "Perfect at the perfect price.", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/96acdd8c-5f52-4570-a23f-44580fd3332d._CR0%2C0%2C500%2C500_SX460_.jpeg", "url": "/gp/profile/amzn1.account.AG3SQQFDFIM3P2B4ROWN3AQGDE7Q" }, "rater": "Kevin James", "rating": 5 }, { "body": "Quick delivery", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AGHCOC3QWN37KKJYDEJQIDPTP3PA" }, "rater": "meh", "rating": 5 }, { "body": "Cant fing hiw to cancel and it says it was out for delivery 20 days ago. Still saying product delayed.", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AEMGX4ATNYWZEKS55MKAWJAJTQUA" }, "rater": "Amazon Customer", "rating": 1 }, { "body": "VERY GOOD", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AF43XLRQSDNPNU4OSTTAVC5QFRUA" }, "rater": "Thomas E Murphy", "rating": 5 }, { "body": "GREAT", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AGUKARATPCW6E7VRUCJPFLVVTMNA" }, "rater": "Tom ", "rating": 5 }, { "body": "Description is good. I am satisfied.", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AHIVKPBJ2H4HZP7MDK6CGYJPIOVQ" }, "rater": "Castleman", "rating": 5 }, { "body": "2 Piece, Soft Absorbent Microfiber Bath Mats and U-Shaped Contour Toilet Rug and I click on larger size only to now see that it is a totally different style rug that is does not include a U-Shaped Contour Toilet Rug... No wonder it was on sale, this is bait and switch crap.", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AG3NPUGN433UP6F44O6CCNUBQOVA" }, "rater": "GoBoSox", "rating": 1 }, { "body": "This order was delivered when promised, and was without damage.", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AEE3QGHLMD4PQVZTX5OFQTP2I7CA" }, "rater": "catchatter 7", "rating": 5 }, { "body": "great service nice mat", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AEUHCBKYEQG7YE25FPIV4AM5E2BQ" }, "rater": "Karl k.", "rating": 4 }, { "body": "DO NOT BUY FROM THIS SELLER! Order was supposed to arrive within 2 days from order date. Watched the tracking and it kept pushing out. Then all the sudden I see the seller cancelled the order without any type of communication with me. Again, do not buy from this seller unless you want to wait on the product just to have your order cancelled w/o your knowledge", "date": { "raw": "April 26, 2026", "timestamp": 1777161600000 }, "has_response": false, "profile": { "avatar": "https://m.media-amazon.com/images/S/amazon-avatars-global/default.png", "url": "/gp/profile/amzn1.account.AGRJXOFUW73XLTEXZEILRTRGEJ4Q" }, "rater": "Aaron", "rating": 1 } ], "pagination": [ { "current_page": 1, "has_next_page": true, "next_page": 2 }, { "current_page": 2, "has_next_page": true, "next_page": 3 } ], "not_match": [] } } ``` {% endcode %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/seller-feedback/response.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.