# 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. |
| `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. |
### 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. |
## Sample JSON Output
{% code overflow="wrap" %}
```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:50.068Z",
"total_time_taken": 6.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",
"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",
"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"
}
// ... 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"]
}
],
"delivered_to": "Wilmington 19805"
}
}
```
{% endcode %}
---
# Agent Instructions: 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:
```
GET https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/seller-products/response.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.