> 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-profile/response.md). # Response The Seller Profile operation returns a merchant's business identity, feedback metrics, and recent customer feedback. Every request returns a structured JSON object with the request metadata and a `result` payload. ## API Response Structure Overview The response is organized into four top-level sections: * `request_info` — Status of the API call, request ID, credit consumption, and location details. * `request_parameters` — Echoes back the parameters you sent, to confirm what was processed. * `request_metadata` — Timestamps for when the request was created and processed. * `result` — The core payload: seller identity, feedback summary, and recent feedback. ## 1. Top-Level Meta Fields (Outside of `result`) ### `request_info` (Object) Contains metadata about the current API request, including status, credit consumption, and geolocation details. | Field | Type | Parent | Description | | -------------------------- | ----------------- | ----------------------- | -------------------------------------------------------------------------- | | `id` | string | request\_info | Unique ID of the request for tracing and debugging. | | `success` | boolean | request\_info | Indicates if the API call was successful. | | `status_code` | number | request\_info | HTTP-like status code returned by the API. | | `error_details` | array | request\_info | List of error messages or objects if the request failed. Empty on success. | | `credits_used` | number | request\_info | Total credits used by the account so far. | | `credit_used_this_request` | number | request\_info | Number of credits consumed by this specific request. | | `credits_remaining` | number | request\_info | Remaining credits available to the account. | | `credits_reset_at` | string (ISO date) | request\_info | When the credit limit will reset. | | `address.city` | string \| null | request\_info > address | Resolved city from the request location, if available. | | `address.district` | string \| null | request\_info > address | Resolved district, if available. | | `address.country_code` | string \| null | request\_info > address | Resolved country code, if available. | | `address.zipCode` | array of strings | request\_info > address | Zip code(s) used to localize the request. | ### `request_parameters` (Object) Echoes back the query parameters sent in the original request. | Field | Type | Parent | Description | | ----------- | ------ | ------------------- | ----------------------------------------------- | | `seller_id` | string | request\_parameters | The Seller ID that was processed. | | `type` | string | request\_parameters | Type of request, i.e. `"SELLER_PROFILE"`. | | `language` | string | request\_parameters | Language code used for the marketplace request. | ### `request_metadata` (Object) Performance-related metadata about how long the request took and when it was processed. | Field | Type | Parent | Description | | ------------------ | ----------------------- | ----------------- | ---------------------------------------------------------- | | `created_at` | string (ISO datetime) | request\_metadata | Timestamp when the request was initiated. | | `processed_at` | string (ISO datetime) | request\_metadata | Timestamp when the request was fully processed. | | `total_time_taken` | number (float, seconds) | request\_metadata | Duration in seconds from request initiation to completion. | ## 2. Core Response Payload – `result` Section All seller data is nested inside `result`. ### `seller_details` (Object) The public and legal identification of the merchant. | Field | Type | Parent | Description | | -------------------------- | ---------------- | --------------- | ------------------------------------------------------------------ | | `name` | string | seller\_details | The public store name as displayed on the marketplace. | | `business_name` | string | seller\_details | The registered legal business name. | | `business_address` | string | seller\_details | The registered business address as a single string. | | `business_address_rows` | array of strings | seller\_details | The business address split into its individual lines. | | `business_country` | string | seller\_details | Country of the registered business. | | `detailed_information` | string | seller\_details | Full seller information text, including business name and address. | | `logo` | string | seller\_details | URL of the seller's logo image. | | `main_image` | object | seller\_details | Structured object with the logo image `id` and `link`. | | ↳ `id` | string | main\_image | Image identifier. | | ↳ `link` | string | main\_image | Direct URL to the image. | | `rating` | number | seller\_details | Average seller rating, on a scale of five. | | `ratings_total` | number | seller\_details | Total number of ratings the seller has received. | | `ratings_total_percentage` | number | seller\_details | Overall positive feedback percentage. | | `store_link` | string | seller\_details | Direct URL to the seller's storefront. | ### `feedback_summary` (Object) A breakdown of seller feedback across four timeframes. Each timeframe is an object keyed by star level. | Field | Type | Parent | Description | | ---------- | ------ | ----------------- | ---------------------------------------------------- | | `1_month` | object | feedback\_summary | Feedback breakdown for the last month. | | `3_month` | object | feedback\_summary | Feedback breakdown for the last three months. | | `12_month` | object | feedback\_summary | Feedback breakdown for the last twelve months. | | `all_time` | object | feedback\_summary | Feedback breakdown across the seller's full history. | Each timeframe object contains the same fields: | Field | Type | Parent | Description | | -------- | ------ | ----------- | -------------------------------------------------------------------- | | `1_star` | string | (timeframe) | Percentage of 1-star feedback, including the `%` sign (e.g. `"1%"`). | | `2_star` | string | (timeframe) | Percentage of 2-star feedback. | | `3_star` | string | (timeframe) | Percentage of 3-star feedback. | | `4_star` | string | (timeframe) | Percentage of 4-star feedback. | | `5_star` | string | (timeframe) | Percentage of 5-star feedback. | | `count` | number | (timeframe) | Total number of feedback entries in this timeframe. | ### `feedback` (Array of objects) A list of the most recent customer feedback left for the seller. | Field | Type | Parent | Description | | --------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------ | | `body` | string | feedback\[] | The text content of the customer feedback. | | `rating` | string | feedback\[] | The star rating given, as a string (e.g. `"4.0"`). | | `rater` | string | feedback\[] | The reviewer name combined with the date of the feedback. | | `position` | number | feedback\[] | Zero-based position of this entry in the feedback list. | | `is_strikethrough` | boolean | feedback\[] | Whether Amazon struck through this feedback due to a fulfillment issue. | | `message_from_amazon` | string | feedback\[] | Amazon's note about the fulfillment issue. Present only when `is_strikethrough` is `true`. | ### Main Result Fields | Field | Type | Parent | Description | | ---------------- | ---------------- | ------ | ---------------------------------------------------------------------------- | | `country_code` | string | result | ISO country code of the marketplace where the profile was retrieved. | | `ask_a_question` | string | result | Direct URL to the Amazon contact page for this seller. | | `not_match` | array of strings | result | Names of fields that could not be retrieved for this seller. See note below. | {% hint style="info" %} Not every field is guaranteed for every seller. When a field cannot be retrieved for a given `seller_id`, its name is listed in `not_match` instead of appearing in the result. An empty `not_match` means all expected fields were returned. {% endhint %} ### Sample JSON Output {% code overflow="wrap" expandable="true" %} ```json { "request_info": { "id": "1d757c8a-39bb-4623-bf0c-8e8680248d96", "success": true, "status_code": 200, "error_details": [], "credits_used": 9512, "credit_used_this_request": 1, "credits_remaining": 990488, "credits_reset_at": "2028-12-09T08:46:47.000Z", "address": { "city": null, "district": null, "country_code": null, "zipCode": ["19805"] } }, "request_parameters": { "output": "json", "language": "en_US", "include_html": false, "seller_id": "AAK72K4OIWDXL", "type": "SELLER_PROFILE" }, "request_metadata": { "created_at": "2026-08-24T13:41:25.179Z", "processed_at": "2026-08-24T13:41:26.232Z", "total_time_taken": 1.053 }, "result": { "seller_details": { "business_address": "11307 W MCFARLANE RD, STE 107, AIRWAY HEIGHTS, WA, 99001, US", "business_address_rows": ["11307 W MCFARLANE RD", "STE 107", "AIRWAY HEIGHTS", "WA", "99001", "US"], "business_country": "US", "business_name": "HUPPINS ONECALL", "detailed_information": "Detailed Seller Information Business Name: HUPPINS ONECALL Business Address: 11307 W MCFARLANE RD STE 107 AIRWAY HEIGHTS WA 99001 US", "logo": "https://m.media-amazon.com/images/I/01EQ+pWzelL.jpg", "main_image": { "id": "01EQ+pWzelL", "link": "https://m.media-amazon.com/images/I/01EQ+pWzelL.jpg" }, "name": "Huppins", "rating": 4.9, "ratings_total": 1363, "ratings_total_percentage": 100, "store_link": "https://www.amazon.com/s?ie=UTF8&marketplaceID=ATVPDKIKX0DER&me=AAK72K4OIWDXL" }, "feedback_summary": { "1_month": { "1_star": "1%", "2_star": "0%", "3_star": "1%", "4_star": "4%", "5_star": "94%", "count": 103 }, "3_month": { "1_star": "0%", "2_star": "0%", "3_star": "0%", "4_star": "4%", "5_star": "96%", "count": 294 }, "12_month": { "1_star": "0%", "2_star": "0%", "3_star": "0%", "4_star": "5%", "5_star": "95%", "count": 1363 }, "all_time": { "1_star": "0%", "2_star": "0%", "3_star": "0%", "4_star": "6%", "5_star": "94%", "count": 42050 } }, "feedback": [ { "body": "Good delilery to me.", "is_strikethrough": false, "position": 0, "rater": "By Buu Em Tran on August 24, 2026.", "rating": "4.0" }, { "body": "Item was supposed to be delivered yesterday. I'm not at that address anymore. Cancel the item.", "is_strikethrough": true, "message_from_amazon": "This item was fulfilled by Amazon, and we take responsibility for this fulfillment experience.", "position": 3, "rater": "By Amazon Customer on August 23, 2026.", "rating": "1.0" } ], "not_match": [], "ask_a_question": "https://amazon.com/gp/help/contact-seller/contact-seller.html?sellerID=AAK72K4OIWDXL&marketplaceID=ATVPDKIKX0DER&ref_=v_sp_contact_seller" } } ``` {% endcode %}