# Macy's API: Search products > Searches Macy's products in the site's order with optional USD price bounds, sale-only results and sorting. Prices for products with a range use the lowest shown price. Unofficial. Not affiliated with or endorsed by Macy's. - Page: https://fous.com/methods/macys.com/search-products - Method: `macys.com/search_products`, version 1 - Website: macys.com - Returns: product name, brand, price, original price, discount, rating, reviews, colours, image, link, product ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `sort` | string | no | `"price_low_to_high"` | Sort results, for example best_sellers. One of "featured", "best_sellers", "top_rated", "newest", "price_low_to_high", "price_high_to_low". Default "featured". | | `query` | string | yes | `"boots"` | What to find, such as women's winter coat. | | `max_price` | number | no | `150` | Maximum price in USD, for example 250. Default 1000000. | | `min_price` | number | no | `100` | Minimum price in USD, for example 50. Default 0. | | `max_results` | integer | no | `6` | Maximum products to return, for example 24. Default 24. | | `on_sale_only` | boolean | no | `true` | Show only products in Macy’s sale and discount selection, for example true. Default false. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "sort": "price_low_to_high", "query": "boots", "max_price": 150, "min_price": 100, "max_results": 6, "on_sale_only": true } ``` Its output: ```json { "products": [ { "brand": "Tommy Hilfiger", "price": 100.56, "colours": [ "Black", "Dark Brown" ], "image_link": "https://slimages.macysassets.com/is/image/MCY/products/1/optimized/39046801_fpx.tif?qlt=80,0&resMode=sharp2&op_usm=1.75,0.3,2,0&fmt=jpeg&wid=342&hei=417&layer=1&bgcolor=100,100,100&opac=5&bgc=247,247,247", "product_id": "28324244", "star_rating": null, "product_link": "https://www.macys.com/shop/product/tommy-hilfiger-womens-missia-knee-high-boots?ID=28324244&isDlp=true#PRICE,SPECIAL_OFFERS,SORTBY/100%257C150,Sales%20%26%20Discounts,PRICE_LOW_TO_HIGH", "product_name": "NEW! Women's Missia Knee-High Boots", "review_count": null, "currency_code": "USD", "original_price": 169, "discount_percent": 40 }, { "brand": "Tommy Hilfiger", "price": 100.56, "colours": [ "Black", "Dark Red", "Dark Brown" ], "image_link": "https://slimages.macysassets.com/is/image/MCY/products/0/optimized/38119570_fpx.tif?qlt=80,0&resMode=sharp2&op_usm=1.75,0.3,2,0&fmt=jpeg&wid=342&hei=417&layer=1&bgcolor=100,100,100&opac=5&bgc=247,247,247", "product_id": "27632742", "star_rating": 5, "product_link": "https://www.macys.com/shop/product/tommy-hilfiger-womens-jolay-tall-pointed-toe-dress-boots?ID=27632742&isDlp=true#PRICE,SPECIAL_OFFERS,SORTBY/100%257C150,Sales%20%26%20Discounts,PRICE_LOW_TO_HIGH", "product_name": "Women's Jolay Pointed Toe Tall Dress Boots", "review_count": 1, "currency_code": "USD", "original_price": 169, "discount_percent": 40 }, { "brand": "Jessica Simpson", "price": 100.56, "colours": [ "Cherry Mahogany", "Indigo Dark Denin", "Black Nappa" ], "image_link": "https://slimages.macysassets.com/is/image/MCY/products/7/optimized/36932387_fpx.tif?qlt=80,0&resMode=sharp2&op_usm=1.75,0.3,2,0&fmt=jpeg&wid=342&hei=417&layer=1&bgcolor=100,100,100&opac=5&bgc=247,247,247", "product_id": "25941179", "star_rating": null, "product_link": "https://www.macys.com/shop/product/jessica-simpson-womens-zuliena-cowboy-half-zip-boots?ID=25941179&isDlp=true#PRICE,SPECIAL_OFFERS,SORTBY/100%257C150,Sales%20%26%20Discounts,PRICE_LOW_TO_HIGH", "product_name": "Women's Zuliena Tall Western Cowboy Boots", "review_count": null, "currency_code": "USD", "original_price": 169, "discount_percent": 40 } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"macys.com/search_products","input":{"sort":"price_low_to_high","query":"boots","max_price":150,"min_price":100,"max_results":6,"on_sale_only":true}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find men's leather dress shoes under $150 on Macy's, sorted by top rated - Show me the 10 best-selling women's down puffer jackets currently on sale - I need a stand mixer between $200 and $400 — list options with ratings and review counts, cheapest first - What's new in girls' party dresses at Macy's? Give me up to 30 results - Looking for discounted queen-size cotton sheet sets, max $80, highest price first so I can see the premium ones ## Input schema ```json { "type": "object", "required": [ "query" ], "properties": { "sort": { "enum": [ "featured", "best_sellers", "top_rated", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "default": "featured", "description": "Sort results, for example best_sellers." }, "query": { "type": "string", "minLength": 1, "description": "What to find, such as women's winter coat." }, "max_price": { "type": "number", "default": 1000000, "minimum": 0, "description": "Maximum price in USD, for example 250." }, "min_price": { "type": "number", "default": 0, "minimum": 0, "description": "Minimum price in USD, for example 50." }, "max_results": { "type": "integer", "default": 24, "maximum": 96, "minimum": 1, "description": "Maximum products to return, for example 24." }, "on_sale_only": { "type": "boolean", "default": false, "description": "Show only products in Macy’s sale and discount selection, for example true." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "products" ], "properties": { "products": { "type": "array", "items": { "type": "object", "required": [ "product_name", "brand", "price", "currency_code", "original_price", "discount_percent", "star_rating", "review_count", "colours", "image_link", "product_link", "product_id" ], "properties": { "brand": { "type": [ "string", "null" ] }, "price": { "type": [ "number", "null" ], "description": "Current displayed USD price." }, "colours": { "type": "array", "items": { "type": "string" } }, "image_link": { "type": [ "string", "null" ] }, "product_id": { "type": "string", "x-fous-developer": true }, "star_rating": { "type": [ "number", "null" ] }, "product_link": { "type": "string" }, "product_name": { "type": "string" }, "review_count": { "type": [ "integer", "null" ] }, "currency_code": { "type": "string" }, "original_price": { "type": [ "number", "null" ], "description": "Original USD price when shown." }, "discount_percent": { "type": [ "number", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Nordstrom API: Search products](https://fous.com/methods/nordstrom.com/search-products.md): Search Nordstrom products by words, price, sale status and sort order. Prices are the lowest listed price. Available sizes may be empty when a product page is unavailable. - [Kohl's API: Search products](https://fous.com/methods/kohls.com/search-products.md): Searches Kohl's products in site order and returns prices, offers, ratings and links for each result. - [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so. - [Walmart API: Search products](https://fous.com/methods/walmart.com/search-products.md): Searches Walmart products by keywords with optional sort and price range, returning prices, ratings, sellers and availability in Walmart's order. Uses Walmart's default location (no ZIP-based pricing). - [H&M API: Search products](https://fous.com/methods/hm.com/search-products.md): Searches H&M clothing and home products by keyword, with country-specific prices and an optional sale-only filter. - [Sephora API: Search products](https://fous.com/methods/sephora.com/search-products.md): Searches Sephora US beauty products in Sephora's order, with brand and USD price filters and shopper sort options. Loves counts are null when a product page cannot be loaded. - [Ulta Beauty API: Search products](https://fous.com/methods/ulta.com/search-products.md): Searches Ulta Beauty products by keyword, brand, USD price range and sort order, and returns each product with its starting prices. - [Best Buy API: Search products](https://fous.com/methods/bestbuy.com/search-products.md): Searches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.