Skip to content
Docs

Seller Products Response

The result object contains the seller's product listings for the requested pages, the storefront refinements, pagination details and the total result count. Every response uses the shared response envelope (request_info, request_parameters, request_metadata, result).

Response structure

result
├── seller_products[]          one entry per product on the fetched pages
│   ├── asin, title, brand, link, image, product_type, position
│   ├── main_image             id, link
│   ├── price                  currency, raw, symbol, value
│   ├── prices[]               currency, raw, symbol, value, is_rrp
│   ├── rating, rating_text, ratings_total
│   ├── categories[]           id, name
│   ├── color_options          additional_count, raw, total_count
│   ├── is_prime, is_sponsored, shipping_details, coupon_text
│   └── availability, quantity, source_page
├── refinements                filter groups, keyed by group name
│   └── <group>[]              link, name, refinement_display_name, value
├── pagination[]               one entry per fetched page
├── result_information         begin, end, raw, total_product_count
└── delivered_to               delivery location used for the results

Fields without a value for a product can be missing from that product's object. For example, coupon_text appears only when a coupon applies.

Result fields

result

FieldTypeDescription
seller_productsarrayProducts listed by the seller on the fetched pages.
refinementsobjectFilter options Amazon shows for the storefront. Left out when exclude_refinements=true.
paginationarrayPaging details, one object per fetched page.
result_informationobjectResult range of the page and the total product count.
delivered_tostringDelivery location used for the results, for example Wilmington 19805.

result.seller_products[]

FieldTypeDescription
positionintegerPosition of the product in the storefront listing. In the sample, the first product has position 0.
asinstringASIN of the product.
titlestringProduct title.
brandstringBrand of the product.
linkstringURL of the product detail page on Amazon. Includes your associate_id when you send one.
imagestringID of the main image, for example 919C-98QIiL. This is not a URL; use main_image.link for the image URL.
main_imageobjectMain image with its id and full-size link.
product_typestringAmazon product type code, for example RUG.
is_primebooleantrue when the product is Prime eligible.
is_sponsoredbooleantrue when the listing is a sponsored placement.
priceobjectCurrent price. See seller_products[].price below.
pricesarrayAll prices shown on the listing, such as the current price and the list price. Each entry has the price fields, and is_rrp is true for the list (recommended retail) price.
ratingstringAverage star rating, for example "4.5".
rating_textstringRating as display text, for example 4.5 out of 5 stars.
ratings_totalintegerTotal number of ratings.
categoriesarrayCategories of the listing, each with id and name.
color_optionsobjectColor variant counts. See seller_products[].color_options below.
shipping_detailsstringDelivery text shown on the listing.
coupon_textstringCoupon or discount text, when a coupon applies.
availabilityobjectAvailability status of the product, when Amazon shows it.
quantityobjectAvailable quantity of the product, when Amazon shows it.
source_pageintegerStorefront page the product was found on.

seller_products[].price

The same fields appear in each entry of prices[].

FieldTypeDescription
currencystringISO 4217 currency code, for example USD.
rawstringPrice as displayed, for example $7.59.
symbolstringCurrency symbol, for example $.
valuestringNumeric price as a string, for example "7.59".

seller_products[].color_options

FieldTypeDescription
total_countintegerTotal number of color variants.
additional_countintegerNumber of variants beyond the ones shown on the listing.
rawstringVariant count as displayed, for example +24.

result.refinements

An object whose keys are refinement groups. Each group is an array of filter options, and a group can be empty. The groups depend on the seller and the marketplace. Groups seen in responses include availability, condition, customer_reviews, deals_discounts, delivery_day, department, eligible_for_free_shipping, international_shipping and sustainability_features.

Each option has these fields:

FieldTypeDescription
namestringOption label, for example Home & Kitchen.
refinement_display_namestringLabel of the group, for example Department.
valuestringRefinement IDs for this option, for example n:1055398,p_6:A1MCYUGJD2ILFU.
linkstringAmazon URL of the storefront with this filter applied.

result.pagination[]

FieldTypeDescription
current_pageintegerPage number of this entry.
current_page_linkstringQuery string of the current page.
next_page_linkstringRelative Amazon path of the next page.
last_visible_pageintegerHighest page number shown in Amazon's page navigation.
result_countintegerNumber of products on this page.
not_matcharrayMarkers for expected page elements that were not found on the page, for example amazon_no_results_text.

result.result_information

Totals for the whole result set, independent of the page entries in pagination.

FieldTypeDescription
beginintegerNumber of the first result on the page, for example 1.
endintegerNumber of the last result on the page, for example 48.
rawstringResult range as displayed, for example 1-48 of over 1,000 results.
total_product_countintegerTotal number of products found for the seller across all pages.

Sample response

Sample response (SELLER_PRODUCTS, .com)

The sample is shortened: // ... AND MORE PRODUCTS marks where the remaining products were removed, so the block is not valid JSON as shown.

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

Notes

  • The Real-Time API returns pagination as an array with one object per fetched page. In Data Service results for Bulk API jobs, seller pagination is documented as a single object, so handle both shapes if you use both APIs.
  • price.value is a string ("7.59"). Convert it to a number in your application before you compare or sum prices.
  • If seller_products is empty, check request_info.success and request_info.error_details, and confirm that the seller ID or storefront URL belongs to the selected domain.
Privacy Policy© 2026 Easyparser