Skip to content

Product listings, product prices and product ratings

Back to tools

Shop Macy's products and sales.

Search products

Search products

Search 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.

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.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Products

Choose an action

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 credit

Search 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

FieldTypeRequiredDescription
SortsortTextOptionalSort results, for example best_sellers.Example: Price low to high
QueryqueryTextRequiredWhat to find, such as women's winter coat.Example: women's winter coat
Max Pricemax_priceNumberOptionalMaximum price in USD, for example 250.Example: 150
Min Pricemin_priceNumberOptionalMinimum price in USD, for example 50.Example: 100
Max Resultsmax_resultsNumberOptionalMaximum products to return, for example 24.Example: 5
On Sale Onlyon_sale_onlyYes or noOptionalShow only products in Macy’s sale and discount selection, for example true.Example: Yes

What you get

FieldTypeDescription
ProductsproductsList
Brandproducts[].brandTextExample: DKNY
Priceproducts[].priceNumberCurrent displayed USD price.Example: 149.99
Coloursproducts[].coloursList
Image Linkproducts[].image_linkTextExample: https://slimages.macysassets.com/is/image/MCY/products/1/optimized/37895501_fpx…
Product IDproducts[].product_idTextExample: 26591977
Star Ratingproducts[].star_ratingNumberExample: 4.5
Product Linkproducts[].product_linkTextExample: https://www.macys.com/shop/product/dkny-womens-walker-length-puffer-with-faux-f…
Product Nameproducts[].product_nameTextExample: Women's Walker Length Puffer with Faux Fur Trimmed Hood Coat
Review Countproducts[].review_countNumberExample: 2552
Currency Codeproducts[].currency_codeTextExample: USD
Original Priceproducts[].original_priceNumberOriginal USD price when shown.Example: 285
Discount (%)products[].discount_percentNumberExample: 47

Example result

For Query: women's winter coat, Max Results: 5

JSON
{
  "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
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.

All Commerce toolsBrowse all tools