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

{
  "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‌"
  }
}