Shop Macy's products and sales.
Your information
What to find, such as women's winter coat.
Maximum products to return, for example 24.
More options
Sort results, for example “Best sellers”.
Maximum price in USD, for example 250.
Minimum price in USD, for example 50.
Show only products in Macy’s sale and discount selection, for example true.
Example results
Products
About the Macy's tool
Macy's, also known as Macys, has a Search products method that returns product names, brands, prices, colours, ratings, and review counts.
Search products requires a query and optionally accepts price bounds, a sale-only filter, sorting, and a maximum result count.
Built from macys.com. Last checked Sep 29, 2026.
Actions
Search products
1 creditSearch 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; promotions and availability can change.
What you provide
| Field | Type | Required | Description |
|---|---|---|---|
Sortsort | Text | Optional | Sort results, for example best_sellers.Example: Price low to high |
Queryquery | Text | Required | What to find, such as women's winter coat.Example: women's winter coat |
Max Pricemax_price | Number | Optional | Maximum price in USD, for example 250.Example: 150 |
Min Pricemin_price | Number | Optional | Minimum price in USD, for example 50.Example: 100 |
Max Resultsmax_results | Number | Optional | Maximum products to return, for example 24.Example: 5 |
On Sale Onlyon_sale_only | Yes or no | Optional | Show only products in Macy’s sale and discount selection, for example true.Example: Yes |
What you get
| Field | Type | Description |
|---|---|---|
Productsproducts | List | |
Brandproducts[].brand | Text | Example: DKNY |
Priceproducts[].price | Number | Current displayed USD price.Example: 149.99 |
Coloursproducts[].colours | List | |
Image Linkproducts[].image_link | Text | Example: https://slimages.macysassets.com/is/image/MCY/products/1/optimized/37895501_fpx… |
Product IDproducts[].product_id | Text | Example: 26591977 |
Star Ratingproducts[].star_rating | Number | Example: 4.5 |
Product Linkproducts[].product_link | Text | Example: https://www.macys.com/shop/product/dkny-womens-walker-length-puffer-with-faux-f… |
Product Nameproducts[].product_name | Text | Example: Women's Walker Length Puffer with Faux Fur Trimmed Hood Coat |
Review Countproducts[].review_count | Number | Example: 2552 |
Currency Codeproducts[].currency_code | Text | Example: USD |
Original Priceproducts[].original_price | Number | Original USD price when shown.Example: 285 |
Discount (%)products[].discount_percent | Number | Example: 47 |
Example result
For Query: women's winter coat, Max Results: 5
{
"products": [
{
"brand": "DKNY",
"price": 149.99,
"colours": [
"Loden",
"Bitter"
],
"image_link": "https://slimages.macysassets.com/is/image/MCY/products/1/optimized/37895501_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,…",
"product_id": "26591977",
"star_rating": null,
"product_link": "https://www.macys.com/shop/product/dkny-womens-walker-length-puffer-with-faux-fur-trimmed-hood-coat?ID=26591977&isDlp=true",
"product_name": "Women's Walker Length Puffer with Faux Fur Trimmed Hood Coat",
"review_count": null,
"currency_code": "USD",
"original_price": 285,
"discount_percent": 47
},
{
"brand": "Lauren Ralph Lauren",
"price": 255.5,
"colours": [
"Black",
"Dk Navy"
],
"image_link": "https://slimages.macysassets.com/is/image/MCY/products/9/optimized/28448939_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,…",
"product_id": "23951208",
"star_rating": 4.5,
"product_link": "https://www.macys.com/shop/product/lauren-ralph-lauren-womens-faux-fur-hooded-puffer-coat-p-xs-xxl?ID=23951208&isDlp=true",
"product_name": "Women's Faux-Fur Hooded Puffer Coat",
"review_count": 2552,
"currency_code": "USD",
"original_price": 365,
"discount_percent": 30
}
]
}For developers
Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.
curl 'https://api.fous.com/v1/query' \
--fail-with-body --silent --show-error --max-time 180 \
-H "Authorization: Bearer YOUR_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"api": "@macys",
"visibility": "public",
"operation": "search_products",
"version": 1,
"input": {
"query": "women'\''s winter coat",
"max_results": 5
},
"response": {
"format": "json"
}
}'What you can do with it
- Find products matching a shopping query
- Compare displayed prices across products
- Review product ratings and review counts
- Find sale products within a price range
Questions about Macy's
Can I run it with my own inputs?
Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.
Can I call this Macy's tool as an API?
Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.
How much does it cost?
Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.
Do I need a Macy's account?
No. You only need a Fous account.
How current is the data?
Fous gets the data from macys.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.
What products match a search?
Search products takes a required query and returns matching product details.
Which products are on sale within my budget?
Search products can filter for sale products and accept minimum and maximum price bounds.
What are a product's price and rating?
Search products returns the displayed price, star rating, review count, and original price when shown.