# Seller Products: Response

> Response fields of the Easyparser SELLER_PRODUCTS operation: product listings, prices, refinements, pagination and a sample JSON response.

Source: https://docs.easyparser.com/real-time-integration/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](/real-time-integration/overview#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`

| Field | Type | Description |
|---|---|---|
| `seller_products` | array | Products listed by the seller on the fetched pages. |
| `refinements` | object | Filter options Amazon shows for the storefront. Left out when `exclude_refinements=true`. |
| `pagination` | array | Paging details, one object per fetched page. |
| `result_information` | object | Result range of the page and the total product count. |
| `delivered_to` | string | Delivery location used for the results, for example `Wilmington 19805`. |

### `result.seller_products[]`

| Field | Type | Description |
|---|---|---|
| `position` | integer | Position of the product in the storefront listing. In the sample, the first product has position `0`. |
| `asin` | string | ASIN of the product. |
| `title` | string | Product title. |
| `brand` | string | Brand of the product. |
| `link` | string | URL of the product detail page on Amazon. Includes your `associate_id` when you send one. |
| `image` | string | ID of the main image, for example `919C-98QIiL`. This is not a URL; use `main_image.link` for the image URL. |
| `main_image` | object | Main image with its `id` and full-size `link`. |
| `product_type` | string | Amazon product type code, for example `RUG`. |
| `is_prime` | boolean | `true` when the product is Prime eligible. |
| `is_sponsored` | boolean | `true` when the listing is a sponsored placement. |
| `price` | object | Current price. See `seller_products[].price` below. |
| `prices` | array | All 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. |
| `rating` | string | Average star rating, for example `"4.5"`. |
| `rating_text` | string | Rating as display text, for example `4.5 out of 5 stars`. |
| `ratings_total` | integer | Total number of ratings. |
| `categories` | array | Categories of the listing, each with `id` and `name`. |
| `color_options` | object | Color variant counts. See `seller_products[].color_options` below. |
| `shipping_details` | string | Delivery text shown on the listing. |
| `coupon_text` | string | Coupon or discount text, when a coupon applies. |
| `availability` | object | Availability status of the product, when Amazon shows it. |
| `quantity` | object | Available quantity of the product, when Amazon shows it. |
| `source_page` | integer | Storefront page the product was found on. |

### `seller_products[].price`

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

| Field | Type | Description |
|---|---|---|
| `currency` | string | ISO 4217 currency code, for example `USD`. |
| `raw` | string | Price as displayed, for example `$7.59`. |
| `symbol` | string | Currency symbol, for example `$`. |
| `value` | string | Numeric price as a string, for example `"7.59"`. |

### `seller_products[].color_options`

| Field | Type | Description |
|---|---|---|
| `total_count` | integer | Total number of color variants. |
| `additional_count` | integer | Number of variants beyond the ones shown on the listing. |
| `raw` | string | Variant 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:

| Field | Type | Description |
|---|---|---|
| `name` | string | Option label, for example `Home & Kitchen`. |
| `refinement_display_name` | string | Label of the group, for example `Department`. |
| `value` | string | Refinement IDs for this option, for example `n:1055398,p_6:A1MCYUGJD2ILFU`. |
| `link` | string | Amazon URL of the storefront with this filter applied. |

### `result.pagination[]`

| Field | Type | Description |
|---|---|---|
| `current_page` | integer | Page number of this entry. |
| `current_page_link` | string | Query string of the current page. |
| `next_page_link` | string | Relative Amazon path of the next page. |
| `last_visible_page` | integer | Highest page number shown in Amazon's page navigation. |
| `result_count` | integer | Number of products on this page. |
| `not_match` | array | Markers 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`.

| Field | Type | Description |
|---|---|---|
| `begin` | integer | Number of the first result on the page, for example `1`. |
| `end` | integer | Number of the last result on the page, for example `48`. |
| `raw` | string | Result range as displayed, for example `1-48 of over 1,000 results`. |
| `total_product_count` | integer | Total 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.

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

## Notes

- The Real-Time API returns `pagination` as an array with one object per fetched page. In [Data Service](/bulk-integration/data-service-response) 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`.
