When using the /seller_products endpoint in a request to the Amazon Seller Data API, you will receive results from the specified Amazon Domain.

ScrapeIN retrieves results from the seller product listings page for a single product on Amazon with the following properties:

JSON Example

{
  "seller_products": [
    {
      "position": 1,
      "title": "SAMSUNG 32\" M80B UHD HDR Smart Computer Monitor Screen with Streaming TV, Slimfit Camera Included, Wireless Remote PC Access, Alexa Built-in (LS32BM801UNXGO)",
      "asin": "B09TWW7RS1",
      "link": "https://www.amazon.com/SAMSUNG-Computer-Streaming-Included-LS32BM801UNXGO/dp/B09TWW7RS1/ref=sr_1_1?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-1",
      "categories": [
        {
          "name": "G-Overstock",
          "id": "AD0BANCB0IN2U"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/619GhhC0bIL._AC_UY218_.jpg",
      "rating": 4,
      "ratings_total": 649
    },
    {
      "position": 2,
      "title": "NETGEAR Nighthawk Cable Modem CM1200 - Compatible with All Cable Providers| For Cable Plans Up to 2 Gigabits | 4 x 1G Ethernet Ports | DOCSIS 3.1, Black (Renewed)",
      "asin": "B08HY7KRPT",
      "link": "https://www.amazon.com/NETGEAR-Nighthawk-Cable-Modem-CM1200/dp/B08HY7KRPT/ref=sr_1_2?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-2",
      "availability": {
        "raw": "Only 1 left in stock - order soon."
      },
      "categories": [
        {
          "name": "G-Overstock",
          "id": "AD0BANCB0IN2U"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/7126x-FXEPL._AC_UY218_.jpg",
      "rating": 4.2,
      "ratings_total": 1325,
      "prices": [
        {
          "symbol": "$",
          "value": 114.99,
          "currency": "USD",
          "raw": "$114.99",
          "asin": "B08HY7KRPT",
          "link": "https://www.amazon.com/NETGEAR-Nighthawk-Cable-Modem-CM1200/dp/B08HY7KRPT/ref=sr_1_2?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-2"
        }
      ],
      "price": {
        "symbol": "$",
        "value": 114.99,
        "currency": "USD",
        "raw": "$114.99",
        "asin": "B08HY7KRPT",
        "link": "https://www.amazon.com/NETGEAR-Nighthawk-Cable-Modem-CM1200/dp/B08HY7KRPT/ref=sr_1_2?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-2"
      }
    },
    {
      "position": 3,
      "title": "LG 32GN63T-B 32'' Ultragear QHD 165Hz HDR10 Monitor with NVIDIA G-SYNC Compatibility and AMD FreeSync Premium (Renewed)",
      "asin": "B09J5J2457",
      "link": "https://www.amazon.com/LG-32GN63T-B-Ultragear-Compatibility-FreeSync/dp/B09J5J2457/ref=sr_1_3?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-3",
      "categories": [
        {
          "name": "G-Overstock",
          "id": "AD0BANCB0IN2U"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/610zqOumMOL._AC_UY218_.jpg",
      "is_prime": true,
      "rating": 4.5,
      "ratings_total": 657,
      "prices": [
        {
          "symbol": "$",
          "value": 259.99,
          "currency": "USD",
          "raw": "$259.99",
          "asin": "B09J5J2457",
          "link": "https://www.amazon.com/LG-32GN63T-B-Ultragear-Compatibility-FreeSync/dp/B09J5J2457/ref=sr_1_3?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-3"
        }
      ],
      "price": {
        "symbol": "$",
        "value": 259.99,
        "currency": "USD",
        "raw": "$259.99",
        "asin": "B09J5J2457",
        "link": "https://www.amazon.com/LG-32GN63T-B-Ultragear-Compatibility-FreeSync/dp/B09J5J2457/ref=sr_1_3?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-3"
      }
    },
    {
      "position": 4,
      "title": "LG C2 Series 77-Inch Class OLED evo Smart TV OLED77C2PUA, 2022 - AI-Powered 4K TV, Alexa Built-in",
      "asin": "B09RMSPSK1",
      "link": "https://www.amazon.com/LG-77-Inch-Refresh-AI-Powered-OLED77C2PUA/dp/B09RMSPSK1/ref=sr_1_4?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-4",
      "categories": [
        {
          "name": "G-Overstock",
          "id": "AD0BANCB0IN2U"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/91VMMMlIIRL._AC_UY218_.jpg",
      "rating": 4.6,
      "ratings_total": 2214
    },
    {
      "position": 5,
      "title": "LG 27GN950-B UltraGear Gaming Monitor 27” UHD (3840 x 2160) Nano IPS Display, 1ms Response Time, 144Hz Refresh Rate, G-SYNC Compatibility, AMD FreeSync Premium Pro, Tilt/Height/Pivot Adjustable Stand",
      "asin": "B08BCRYS6B",
      "link": "https://www.amazon.com/LG-27GN950-B-Ultragear-Response-Compatibility/dp/B08BCRYS6B/ref=sr_1_5?m=AD0BANCB0IN2U&qid=1688164193&s=merchant-items&sr=1-5",
      "categories": [
        {
          "name": "G-Overstock",
          "id": "AD0BANCB0IN2U"
        }
      ],
      "image": "https://m.media-amazon.com/images/I/81fdHiIG1dL._AC_UY218_.jpg",
      "rating": 4.4,
      "ratings_total": 1011
    },
  ],
  "refinements": {
    "brand": [
      {
        "name": "SAMSUNG",
        "value": "p_4/SAMSUNG",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3ASAMSUNG&dc&qid=1688164193&ref=sr_nr_p_4_1&ds=v1%3Ar3fANCHl%2FHyw%2BbYex0Iwx3Xwd%2FcfBxo9qGax08VtSz0",
        "refinement_display_name": "Brand"
      },
      {
        "name": "NETGEAR",
        "value": "p_4/NETGEAR",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3ANETGEAR&dc&qid=1688164193&ref=sr_nr_p_4_2&ds=v1%3AaS852qVw4PeiuzY5V4SMba5xieJFBF2ySpqLbXmhbgQ",
        "refinement_display_name": "Brand"
      },
      {
        "name": "LG",
        "value": "p_4/LG",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3ALG&dc&qid=1688164193&ref=sr_nr_p_4_3&ds=v1%3AMf1yOSM7tNb96AZcGHOJGBnPoztbVRZECrKLxZipRBs",
        "refinement_display_name": "Brand"
      },
      {
        "name": "JBL",
        "value": "p_4/JBL",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3AJBL&dc&qid=1688164193&ref=sr_nr_p_4_4&ds=v1%3AXFVTonwdka8Q7lg7hYGhoC4Ol0kpRqTyRWsgKruSbOg",
        "refinement_display_name": "Brand"
      },
      {
        "name": "Shark",
        "value": "p_4/Shark",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3AShark&dc&qid=1688164193&ref=sr_nr_p_4_5&ds=v1%3AsvPMel2cE5r2Ybu8%2Br4vevXXDf%2FZidJ9wXST5OW9JBE",
        "refinement_display_name": "Brand"
      },
      {
        "name": "APC",
        "value": "p_4/APC",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3AAPC&dc&qid=1688164193&ref=sr_nr_p_4_6&ds=v1%3AFh4R%2FF2EvxVwBPT1Mo3xk9x61sqs5tNEDTjtAA0r2RY",
        "refinement_display_name": "Brand"
      },
      {
        "name": "HP",
        "value": "p_4/HP",
        "link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&rh=p_4%3AHP&dc&qid=1688164193&ref=sr_nr_p_4_7&ds=v1%3AYulQVwsT01ZvqX9KnOOizoJJmWjcz9b6JRNt05KA53M",
        "refinement_display_name": "Brand"
      },
    ]
  },
  "pagination": {
    "total_results": 418,
    "current_page": 1,
    "next_page_link": "https://www.amazon.com/s?i=merchant-items&me=AD0BANCB0IN2U&page=2&qid=1688164193&ref=sr_pg_2",
    "total_pages": 27
  }
}

ScrapeIN returns the following properties for requests made with the seller_product endpoint.

JSON Structure

The JSON structure returned by the Amazon Sellers Data API includes required elements, such as request_parameters, request_metadata, pagination, as described in the Results Amazon Data API section. Additionally, it includes parameters specific to the seller's product listings page for a single seller on Amazon. These parameters are described below.

seller_products

An array of objects represents offers from the seller, shown on the page. Each object contains the following properties:

position: The position of the result on the page.
title: The product name.
asin: The Amazon product ID (ASIN) for the product.
link: The product page link.
is_prime: Indicates whether the product is Prime-eligible (true/false).
image: A link to the image of the product.
add_on_item: An optional object indicating if the product is an add-on item. The property will be omitted if the product is not an add-on item.
- is_add_on_item: Indicates whether the product is an add-on item (true/false).
bestseller: An object containing details about whether the product is a bestseller and its category. The object has the following properties:
- category: The name of the category in which the product is a bestseller.
rating: The overall rating of the product, out of 5.
ratings_total: The total number of customer ratings the product has received.
reviews_total: The total number of customer reviews the product has received.
prices: An array of price objects representing the pricing details of the product. Each price object has the following properties:
- symbol: The currency symbol (e.g., $ for USD).
- value: The price of the offer.
- currency: The currency code (ISO 4217) of the offer.
- raw: The raw price is displayed on the offer listing.
- name: The name of the price, if applicable, for example, "Kindle", or "Hardcover".
price: A price object representing the main price for the product. This object is included as a convenience to make extracting the main price easier. It has the same properties as the price objects within the prices array.

refinements

📘
Note on Refinements Values
Refinement values can vary and are specific to different categories. If you want to use refinements, start by making a request with the /seller_products endpoint without specifying any refinements. This will retrieve a complete list of available refinements for the particular seller. Then to narrow down results based on specific refinement values, you need to include the desired refinement values in the request's refinements parameter, separated by commas.
Additionally, you can then store these refinement values for later use in subsequent requests.

An object containing details of the available refinements for the given seller’s products. You can refine retrieved results by using the refinements parameter. To match your preferences, you should specify these refinement values, separated by commas, in the refinements parameter of your request. Each refinement property consists of two values:

name: It indicates a specific brand name, such as "Samsung".
value: The value of the refinement. Multiple refinement values are comma-separated.
link: The link is shown for the refinement. It can be used as a url parameter in a new request to navigate to the seller products results filtered by this refinement. For instance, to retrieve seller products filtered by brand.
refinement_display_name: Indicates the refinement display name. In this case, it is "Brand".

pagination

An object contains details of the current seller products listing page and the total number of available pages and these are:

current_page: The current page number.
total_pages: The total number of pages available for pagination.
total_results: Indicates the total number of results available across all pages.
next_page_link: Provides the URL for the next page of results. You can follow this link to navigate to the next page and retrieve additional results.