Realry — fashion price comparison

Search fashion products on Realry.com. Put only the product itself in `query`, as a short noun phrase ("running shoes", "linen dress", "crossbody bag"), and put gender, price_min/price_max, colors, brand, sale_only/min_discount in their own parameters; use `category` only when the shopper asked for a whole category or the product type is ambiguous. `query` is matched against product text, so sentences and extra words ("for a wedding", "under $100", "cheap", "women's") make it miss. Bad: {"query": "women's black linen summer dress under $100"} Good: {"query": "linen dress", "gender": "women", "colors": "black", "price_max": 100} Good: {"query": "patagonia fleece", "brand": "Patagonia"} Returns product name, price, discount info, seller, and links. Use the Product ID with get_price_comparison to compare prices across all stores. When every store's stock is unconfirmed for 5+ days, those results are listed after fresher ones, so rank is not strict price order under price sorts.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\", \"air force 1\"). No gender, price, colour or filler words — use the other parameters. When the shopper named a brand, keep it in query too and also set `brand`."
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    },
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "gender": {
      "type": "string",
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "category": {
      "type": "string",
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    }
  },
  "required": [
    "query"
  ]
}

Compare prices for a specific fashion product across all stores on Realry.com. Returns stores sorted cheapest first with direct purchase links, the sizes each store lists, and how fresh each store's stock data is.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID from search_products result (shown as \"Product ID: `xxx`\")"
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    }
  },
  "required": [
    "product_id"
  ]
}

Browse the latest new arrivals on Realry.com, sorted by newest first. Optionally filter by keyword, price, gender, or color.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\"). No gender, price, colour or filler words — use the other parameters."
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    },
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "gender": {
      "type": "string",
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "category": {
      "type": "string",
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    }
  }
}

Find sale and discounted fashion products on Realry.com. Optionally filter by keyword, minimum discount percentage, price range, gender, or color.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\"). No gender, price, colour or filler words — use the other parameters."
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    },
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "gender": {
      "type": "string",
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "category": {
      "type": "string",
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    }
  }
}

Discover the most popular and trending fashion products on Realry.com, ranked by user likes. Optionally filter by keyword, price, gender, or color.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\"). No gender, price, colour or filler words — use the other parameters."
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    },
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "gender": {
      "type": "string",
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "category": {
      "type": "string",
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    }
  }
}

Find fashion products similar to a given product on Realry.com. Useful for "show me more like this" or "find alternatives" requests. Use the Product ID from search_products results.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID to find similar items for (shown as \"Product ID: `xxx`\" in search results)"
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    }
  },
  "required": [
    "product_id"
  ]
}

Get the price history of a specific fashion product on Realry.com over the past 30 days. Helps users decide if now is a good time to buy.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product ID to get price history for (shown as \"Product ID: `xxx`\" in search results)"
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    }
  },
  "required": [
    "product_id"
  ]
}

Browse the hottest deals and discounted fashion products on Realry.com. Optionally filter by gender.

{
  "type": "object",
  "properties": {
    "gender": {
      "type": "string",
      "enum": [
        "women",
        "men"
      ],
      "description": "Who the deals are for. Omit for all."
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    },
    "page_length": {
      "type": "number",
      "description": "Number of results to return (default: 5, max: 36)"
    }
  }
}

Search for fashion brands on Realry.com by name. Returns brand IDs that can be used with get_brand_products.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Brand name to search for (e.g. \"nike\", \"gucci\", \"zara\")"
    },
    "limit": {
      "type": "number",
      "description": "Number of results (default: 8)"
    }
  },
  "required": [
    "query"
  ]
}

Get featured products from a specific fashion brand on Realry.com. Use search_brands first to find the brand_id.

{
  "type": "object",
  "properties": {
    "brand_id": {
      "type": "string",
      "description": "Brand ID from search_brands result (shown as \"Brand ID: `xxx`\")"
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    }
  },
  "required": [
    "brand_id"
  ]
}

Compare multiple fashion products side-by-side on Realry.com — shows best price, discount rate, and number of stores for each. Use Product IDs from search_products results. Ideal for "which is cheaper?" or "help me decide between these" questions.

{
  "type": "object",
  "properties": {
    "product_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of 2–5 Product IDs to compare (shown as \"Product ID: `xxx`\" in search results)"
    },
    "country": {
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.",
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ]
    }
  },
  "required": [
    "product_ids"
  ]
}