seller_products

{
  "properties": {
    "seller_id": {
      "description": "Restrict results to one seller's offers (Amazon seller id).",
      "title": "Seller Id",
      "type": "string"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional keywords to search within this seller's storefront.",
      "title": "Query"
    },
    "page": {
      "default": 1,
      "description": "Result page, 1-based. metadata.total_pages says how far it goes.",
      "minimum": 1,
      "title": "Page",
      "type": "integer"
    },
    "geo": {
      "default": "US",
      "description": "Marketplace country code.",
      "enum": [
        "US",
        "CA",
        "DE",
        "MX",
        "UK",
        "FR",
        "IT",
        "ES",
        "AU",
        "BR",
        "IN",
        "JP",
        "NL",
        "AE",
        "PL",
        "SA",
        "SG",
        "SE",
        "TR",
        "BE"
      ],
      "title": "Geo",
      "type": "string"
    },
    "sort_by": {
      "default": "RELEVANCE",
      "description": "Result ordering.",
      "enum": [
        "RELEVANCE",
        "BEST_SELLERS",
        "LOW_HIGH_PRICE",
        "HIGH_LOW_PRICE",
        "REVIEWS",
        "NEWEST"
      ],
      "title": "Sort By",
      "type": "string"
    },
    "category_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Amazon browse node id to restrict to, e.g. 172282 (Electronics on US). Take one from a best_sellers answer's available_subcategories, a product's category_path, or node= in an Amazon URL. Ids differ per marketplace.",
      "title": "Category Id"
    },
    "min_price": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Lowest price, in the marketplace currency; decimals such as 19.99 are fine.",
      "title": "Min Price"
    },
    "max_price": {
      "anyOf": [
        {
          "minimum": 0,
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Highest price, in the marketplace currency.",
      "title": "Max Price"
    },
    "product_condition": {
      "anyOf": [
        {
          "enum": [
            "NEW",
            "USED",
            "RENEWED"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "NEW, USED or RENEWED (case-insensitive). Applied with the marketplace's own condition node; where a marketplace does not offer one, the answer's filters_ignored says so and available_filters lists what it does offer.",
      "title": "Product Condition"
    },
    "brand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Brand name as Amazon spells it (case-insensitive), e.g. Samsung.",
      "title": "Brand"
    },
    "today_deals": {
      "default": false,
      "description": "Only items in Today's Deals, using that marketplace's own refinement. Where a marketplace has none (amazon.fr on 2026-09-08) it is reported under filters_ignored.",
      "title": "Today Deals",
      "type": "boolean"
    },
    "deal_type": {
      "anyOf": [
        {
          "enum": [
            "today_deals",
            "all_discounts",
            "coupons",
            "buy_more_save_more"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A specific promotion refinement: today_deals, all_discounts, coupons or buy_more_save_more. available_filters.deal_type lists the ones this marketplace has.",
      "title": "Deal Type"
    },
    "limit": {
      "default": 10,
      "description": "How many the seller's products to return from this page (0 = all of them). A full page is up to 48 rows and about 54 KB, which most clients spill to a file instead of showing inline. The answer carries _truncated with the true count when it trims.",
      "minimum": 0,
      "title": "Limit",
      "type": "integer"
    },
    "compact": {
      "default": true,
      "description": "Return light rows: identity, price, rating, badges and one delivery_date, dropping the long delivery prose that repeats itself across three fields. false returns every field the REST API sends (roughly 3x the size).",
      "title": "Compact",
      "type": "boolean"
    },
    "fields": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Comma-separated row fields to return instead of the light set, e.g. \"asin,product_title,product_price\". Rows list what they left out under _omitted_fields.",
      "title": "Fields"
    }
  },
  "required": [
    "seller_id"
  ],
  "type": "object",
  "title": "seller_productsArguments"
}