> 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-products/response.md). # Response The response for the Seller Products operation is designed to provide a transparent view of a seller's product listings and associated data. Every request returns a structured JSON object containing product ASINs, pricing, ratings, and other key product attributes. ## API Response Structure Overview The JSON response is organized into four primary sections: 1. **`request_info`:** Contains the status of the API call, unique request ID, and detailed credit consumption information. 2. **`request_parameters`**: Echoes back the parameters you sent, such as seller ID or URL, to confirm what was processed. 3. **`request_metadata`:** Includes timestamps regarding when the request was created and processed. 4. **`result`:** Contains the core payload with product listings and related 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 essential information about the transaction status, parameters, and processing timing. ### request\_info (object) The `request_info` object provides the technical status of your API call and real-time updates on your credit usage. It is the primary reference for debugging and monitoring your account's consumption limits. | Field | Type | Description | | -------------------------- | ------- | ------------------------------------------------------------------- | | `id` | String | A unique identifier assigned to this specific request for tracking. | | `success` | Boolean | Indicates if the operation was completed successfully. | | `status_code` | Integer | The standard HTTP response code for the request. | | `error_details` | Array | An array containing error details, if any. | | `credits_used` | Integer | The total amount of credits deducted for this individual request. | | `credit_used_this_request` | Integer | The amount of credits used for this specific request. | | `credits_remaining` | Integer | Your updated total credit balance after the consumption. | | `credits_reset_at` | String | Timestamp indicating when credits will reset. | | `address` | Object | Address information associated with the request. | ### request\_metadata (object) The `request_metadata` object captures performance-related metrics and timestamps throughout the lifecycle of the request. These details help you evaluate system latency and data freshness. | 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. | ### request\_parameters (object) The `request_parameters` object serves as an echo of the input values you provided in your request. This allows for programmatic verification that the correct parameters were used to generate the response. | Field | Type | Description | | -------------- | ------- | ----------------------------------------------------------- | | `output` | String | The output format (e.g., `json`). | | `language` | String | The language code used for the marketplace request. | | `include_html` | Boolean | Indicates whether HTML content was included. | | `seller_id` | String | The unique ID of the target seller processed by the system. | | `type` | String | The operation type, set to `SELLER_PRODUCTS`. | ## 2. Core Payload (Inside result) The result object contains the specific product data retrieved from the marketplace. ### seller\_products (array) An array of the seller's product listings. | Field | Type | Description | | ------------------ | ------- | --------------------------------------------------------------------------------------------------------------- | | `asin` | String | The Amazon Standard Identification Number for the product. | | `brand` | String | The brand of the product. | | `categories` | Array | The categories the product belongs to. | | `color_options` | Object | Color options available for the product and their total count. | | `image` | String | The URL of the product's main image. | | `main_image` | Object | The primary image object for the product, containing the image `id` and a direct `link` to the full-size image. | | `is_prime` | Boolean | Indicates if the product is eligible for Amazon Prime. | | `is_sponsored` | Boolean | Indicates if the product is sponsored. | | `link` | String | The direct link to the product on Amazon. | | `position` | Integer | The position of the product in the search results. | | `price` | Object | Pricing information for the product (currency, raw value, symbol, value). | | `prices` | Array | Different pricing options for the product. | | `product_type` | String | The type of the product. | | `rating` | String | The average star rating of the product. | | `rating_text` | String | The rating text (e.g., "4.5 out of 5 stars"). | | `ratings_total` | Integer | The total number of ratings the product has received. | | `shipping_details` | String | Shipping details for the product. | | `title` | String | The title of the product. | | `availability` | Object | The availability status of the product. | | `quantity` | Object | The available quantity of the product. | | `coupon_text` | String | The coupon or discount text displayed on the product listing, if a coupon applies. | ### refinements (object) Options available to filter search results. | Field | Type | Description | | ---------------------------- | ----- | ------------------------------------------------ | | `availability` | Array | Filtering options for product availability. | | `condition` | Array | Filtering options for product condition. | | `customer_reviews` | Array | Filtering options based on customer reviews. | | `delivery_day` | Array | Filtering options for delivery day. | | `department` | Array | Filtering options by department. | | `eligible_for_free_shipping` | Array | Filtering options for free shipping eligibility. | | `international_shipping` | Array | Filtering options for international shipping. | ### pagination (array) | Field | Type | Description | | ------------------- | ------- | ------------------------------------------ | | `current_page` | Integer | The current page number. | | `current_page_link` | String | The link to the current page. | | `next_page_link` | String | The link to the next page. | | `result_count` | Integer | The number of results on the current page. | | `not_match` | Array | Items that did not match the criteria. | ### result\_information (object) Summary information about the total result set matched by the search, independent of the current page's `pagination` details. | Field | Type | Description | | --------------------- | ------- | --------------------------------------------------------------------------------- | | `begin` | Integer | The starting result number represented on the current page (e.g., `1`). | | `end` | Integer | The ending result number represented on the current page (e.g., `48`). | | `raw` | String | The raw, human-readable result range text (e.g., `"1-48 of over 1,000 results"`). | | `total_product_count` | Integer | The total number of products found for the seller across all pages. | ### Sample JSON Output ```json { "request_info": { "id": "ecbead7b-e3a0-4261-af04-3efd04f54f4e", "success": true, "status_code": 200, "error_details": [], "credits_used": 1, "credit_used_this_request": 1, "credits_remaining": 99, "credits_reset_at": "2026-04-09T07:41:48.000Z", "address": { "city": null, "district": null, "country_code": null, "zipCode": ["19805"] } }, "request_parameters": { "output": "json", "language": "en_US", "include_html": false, "seller_id": "A1MCYUGJD2ILFU", "type": "SELLER_PRODUCTS" }, "request_metadata": { "created_at": "2026-03-13T23:10:43.526Z", "processed_at": "2026-03-13T23:10:45.068Z", "total_time_taken": 2.542 }, "result": { "seller_products": [ { "asin": "B0FJRQC5LZ", "brand": "OLANLY", "categories": [{ "id": "aps", "name": "All Departments" }], "color_options": { "additional_count": 24, "raw": "+24", "total_count": 30 }, "image": "919C-98QIiL", "main_image": { "id": "919C-98QIiL", "link": "https://m.media-amazon.com/images/I/919C-98QIiL.jpg" }, "is_prime": true, "is_sponsored": false, "link": "https://www.amazon.com/OLANLY-Absorbent-Bathroom-Washable-Accessories/dp/B0FJRQC5LZ/ref=sr_1_1?dib=eyJ2IjoiMSJ9.DMwOYj9pMVOohqLyx195wkolniKIMQQ1HA3NKrRT6y2afK2mO5n9cRb1_bIUXcQ4IYbAg_7246R4qjh22G_Toda90SgWA4PO269JSiTx07WOXCRKOs3rRWP91ZIFSbqirhh-S9uYMYMkh_H2pVYVULjU2ZZBuYFzhAOryy8taeVkRZTbtul6fmJd-rkoNPQZTDyq4IiprJEQDbL1-1ZHthzwESbKeItUXGLfSfV5XpDHqThB6zMbr2phKk1Oda8LlOfK4v_u5bluA9Ym1v-FX8pvhNnFuNDMQhWNUON8pc4.e_NzbryDTFrsjgIxf8PxvX6j3xIFie96AjpBepJVlX4&dib_tag=se&m=A1MCYUGJD2ILFU&qid=1773443444&refinements=p_6%3AA1MCYUGJD2ILFU&sr=8-1", "position": 0, "price": { "currency": "USD", "raw": "$7.59", "symbol": "$", "value": "7.59" }, "prices": [ { "currency": "USD", "raw": "$7.59", "symbol": "$", "value": "7.59" } ], "product_type": "RUG", "rating": "4.5", "rating_text": "4.5 out of 5 stars", "ratings_total": 397, "shipping_details": "FREE delivery Wed, Mar 18 on $35 of items shipped by AmazonOr fastest delivery Overnight 4 AM - 8 AM", "title": "OLANLY Memory Foam Bath Mat 30x20, Super Soft Absorbent Bathroom Rugs, Quick Dry, Machine Washable Shower Floor Rugs, Bathmat Carpet, Bathroom Home Decor Accessories, Grey" }, { "asin": "B0BWT84GZ7", "brand": "OLANLY", "categories": [{ "id": "aps", "name": "All Departments" }], "color_options": { "additional_count": 47, "raw": "+47", "total_count": 53 }, "image": "9102+B7xv+L", "main_image": { "id": "9102+B7xv+L", "link": "https://m.media-amazon.com/images/I/9102+B7xv+L.jpg" }, "is_prime": true, "is_sponsored": false, "link": "https://www.amazon.com/OLANLY-Moisture-Absorbent-Non-Slip-Microfiber/dp/B0BWT84GZ7/ref=sr_1_2?dib=eyJ2IjoiMSJ9.DMwOYj9pMVOohqLyx195wkolniKIMQQ1HA3NKrRT6y2afK2mO5n9cRb1_bIUXcQ4IYbAg_7246R4qjh22G_Toda90SgWA4PO269JSiTx07WOXCRKOs3rRWP91ZIFSbqirhh-S9uYMYMkh_H2pVYVULjU2ZZBuYFzhAOryy8taeVkRZTbtul6fmJd-rkoNPQZTDyq4IiprJEQDbL1-1ZHthzwESbKeItUXGLfSfV5XpDHqThB6zMbr2phKk1Oda8LlOfK4v_u5bluA9Ym1v-FX8pvhNnFuNDMQhWNUON8pc4.e_NzbryDTFrsjgIxf8PxvX6j3xIFie96AjpBepJVlX4&dib_tag=se&m=A1MCYUGJD2ILFU&qid=1773443444&refinements=p_6%3AA1MCYUGJD2ILFU&sr=8-2", "position": 1, "price": { "currency": "USD", "raw": "$9.49", "symbol": "$", "value": "9.49" }, "prices": [ { "currency": "USD", "raw": "$9.49", "symbol": "$", "value": "9.49" } ], "product_type": "RUG", "rating": "4.5", "rating_text": "4.5 out of 5 stars", "ratings_total": 20710, "shipping_details": "FREE delivery Wed, Mar 18 on $35 of items shipped by AmazonOr fastest delivery Overnight 4 AM - 8 AM", "title": "OLANLY Dog Door Mat for Muddy Paws 30x20, Absorbs Moisture and Dirt, Absorbent Non-Slip Washable Doormat, Quick Dry Chenille Mud Mat for Dogs, Entry Indoor Entryway Carpet for Inside Floor, Grey", "coupon_text": "You pay $29.69 – 10% off coupon applied" } // ... AND MORE PRODUCTS ], "refinements": { "availability": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_availability%3A2661601011&dc&language=en_US&qid=1773443444&rnid=2661599011&ref=sr_nr_p_n_availability_2&ds=v1%3ALv%2FcuWiwYHPgW4v0HksXweFvvSz4lvjyxykNizCuxoc", "name": "Include Out of Stock", "refinement_display_name": "Availability", "value": "p_6:A1MCYUGJD2ILFU,p_n_availability:2661601011" } ], "condition": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_condition-type%3A6461716011&dc&language=en_US&qid=1773443444&rnid=6461714011&ref=sr_nr_p_n_condition-type_1&ds=v1%3AfV%2Fw%2F267C%2B8aAENJ%2ByekjCBz31wnwJ9igcH1SOvKtYc", "name": "New", "refinement_display_name": "Condition", "value": "p_6:A1MCYUGJD2ILFU,p_n_condition-type:6461716011" } ], "customer_reviews": [], "deals_discounts": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_deal_type%3A23566065011&dc&language=en_US&qid=1773443444&rnid=23566063011&ref=sr_nr_p_n_deal_type_1&ds=v1%3A%2BTBiypa%2FObJyEk5yDaxMVyczRCENyW3opRxBSXpOyuM", "name": "All Discounts", "refinement_display_name": "Deals & Discounts", "value": "p_6:A1MCYUGJD2ILFU,p_n_deal_type:23566065011" }, { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_deal_type%3A23566064011&dc&language=en_US&qid=1773443444&rnid=23566063011&ref=sr_nr_p_n_deal_type_2&ds=v1%3A6w64tPCmikQSM73jHl4hNeV52%2BQTNT7cLuFXUguYtOE", "name": "Today's Deals", "refinement_display_name": "Deals & Discounts", "value": "p_6:A1MCYUGJD2ILFU,p_n_deal_type:23566064011" } ], "delivery_day": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_90%3A8308921011&dc&language=en_US&qid=1773443444&rnid=8308919011&ref=sr_nr_p_90_1&ds=v1%3AO3DGru2es3QJvBe7Ez9xEDNFhm9AsKd7JosPhOHAicw", "name": "Get It by Tomorrow", "refinement_display_name": "Delivery Day", "value": "p_6:A1MCYUGJD2ILFU,p_90:8308921011" } ], "department": [ { "link": "https://www.amazon.com/s?rh=n%3A1055398%2Cp_6%3AA1MCYUGJD2ILFU&dc&language=en_US&qid=1773443444&rnid=2941120011&ref=sr_nr_n_1&ds=v1%3ALccwU0VifV2CAduTKlQyQC%2FHmgA1RXY92K0VAkCBMHM", "name": "Home & Kitchen", "refinement_display_name": "Department", "value": "n:1055398,p_6:A1MCYUGJD2ILFU" }, { "link": "https://www.amazon.com/s?rh=n%3A2972638011%2Cp_6%3AA1MCYUGJD2ILFU&dc&language=en_US&qid=1773443444&rnid=2941120011&ref=sr_nr_n_2&ds=v1%3ACCcIdJSrXYK3K3rr5OkP9ZEH73AoVv0uikqtkSXNwck", "name": "Patio, Lawn & Garden", "refinement_display_name": "Department", "value": "n:2972638011,p_6:A1MCYUGJD2ILFU" }, { "link": "https://www.amazon.com/s?rh=n%3A2619533011%2Cp_6%3AA1MCYUGJD2ILFU&dc&language=en_US&qid=1773443444&rnid=2941120011&ref=sr_nr_n_3&ds=v1%3AALImWA5meXVvBvON5DrRT%2FNGa6zUpWJbanLs8TuDQyw", "name": "Pet Supplies", "refinement_display_name": "Department", "value": "n:2619533011,p_6:A1MCYUGJD2ILFU" }, { "link": "https://www.amazon.com/s?rh=n%3A228013%2Cp_6%3AA1MCYUGJD2ILFU&dc&language=en_US&qid=1773443444&rnid=2941120011&ref=sr_nr_n_4&ds=v1%3ALijcY0NmEjKiOsISqIFy7u2OLib9plxqpRvVYGR0coo", "name": "Tools & Home Improvement", "refinement_display_name": "Department", "value": "n:228013,p_6:A1MCYUGJD2ILFU" } ], "eligible_for_free_shipping": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_76%3A2661625011&dc&language=en_US&qid=1773443444&rnid=2661623011&ref=sr_nr_p_76_1&ds=v1%3A8q91Es2KfzZezGt%2FppBBSYGPSHtWRU4QxTId5dFUkpk", "name": "Free Shipping by Amazon", "refinement_display_name": "Eligible for Free Shipping", "value": "p_6:A1MCYUGJD2ILFU,p_76:2661625011" } ], "international_shipping": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_shipping_option-bin%3A3242350011&dc&language=en_US&qid=1773443444&rnid=2944662011&ref=sr_nr_p_n_shipping_option-bin_1&ds=v1%3A0L%2BMNiq6Em0v6Qo0tDMXJVQ31qCw%2FZlFAUJ404F%2BJik", "name": "International Shipping Eligible", "refinement_display_name": "International Shipping", "value": "p_6:A1MCYUGJD2ILFU,p_n_shipping_option-bin:3242350011" } ], "sustainability_features": [ { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_cpf_labels%3A121136630011&dc&language=en_US&qid=1773443444&rnid=116845681011&ref=sr_nr_p_n_cpf_labels_1&ds=v1%3AJSsh3G803APdORyMZiDZ6YVP9MtqyZ6yKvp%2FjR3G%2BAc", "name": "Any Feature", "refinement_display_name": "Sustainability Features", "value": "p_6:A1MCYUGJD2ILFU,p_n_cpf_labels:121136630011" }, { "link": "https://www.amazon.com/s?rh=p_6%3AA1MCYUGJD2ILFU%2Cp_n_cpf_labels%3A116845683011&dc&language=en_US&qid=1773443444&rnid=116845681011&ref=sr_nr_p_n_cpf_labels_2&ds=v1%3A1P8yUx690mU6jNot165lJ0%2BW9o1HaJXJrUlwwtsaLPQ", "name": "Safer Chemicals", "refinement_display_name": "Sustainability Features", "value": "p_6:A1MCYUGJD2ILFU,p_n_cpf_labels:116845683011" } ] }, "pagination": [ { "current_page": 1, "current_page_link": "language=en_US&qid=1773443444&rh=p_6%3AA1MCYUGJD2ILFU&xpid=v-7y5fmpYp_-B", "last_visible_page": 7, "next_page_link": "/s?rh=p_6%3AA1MCYUGJD2ILFU&page=2&language=en_US&xpid=v-7y5fmpYp_-B&qid=1773443444&ref=sr_pg_1", "result_count": 48, "not_match": ["amazon_no_results_text"] } ], "result_information": { "begin": 1, "end": 48, "raw": "1-48 of over 1,000 results", "total_product_count": 1000 }, "delivered_to": "Wilmington 19805‌" } } ```