# Macy's API > Macy's returns product listings, prices, and ratings, available as a workflow and API. 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. - Page: https://fous.com/workflows/macys - Handle: `@macys` - Category: [Commerce](https://fous.com/workflows/category/commerce) - Source website: https://macys.com - Last verified: Sep 29, 2026 - Fous is not affiliated with Macy's. ## Methods ### Search products Operation `search_products`, version 1. 1 credit per call. 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. **Input** | Field | Type | Required | Example | Description | |---|---|---|---|---| | `sort` | string | no | `"price_low_to_high"` | Sort results, for example best_sellers. | | `query` | string | yes | `"women's winter coat"` | What to find, such as women's winter coat. | | `max_price` | number | no | `150` | Maximum price in USD, for example 250. | | `min_price` | number | no | `100` | Minimum price in USD, for example 50. | | `max_results` | integer | no | `5` | Maximum products to return, for example 24. | | `on_sale_only` | boolean | no | `true` | Show only products in Macy’s sale and discount selection, for example true. | **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.", "examples": [ "price_low_to_high", "best_sellers" ] }, "query": { "type": "string", "minLength": 1, "description": "What to find, such as women's winter coat.", "examples": [ "women's winter coat", "boots", "zzzzxxnomatch87652534" ] }, "max_price": { "type": "number", "default": 1000000, "minimum": 0, "description": "Maximum price in USD, for example 250.", "examples": [ 150 ] }, "min_price": { "type": "number", "default": 0, "minimum": 0, "description": "Minimum price in USD, for example 50.", "examples": [ 100 ] }, "max_results": { "type": "integer", "default": 24, "maximum": 96, "minimum": 1, "description": "Maximum products to return, for example 24.", "x-fous-developer": true, "examples": [ 5, 6, 4 ] }, "on_sale_only": { "type": "boolean", "default": false, "description": "Show only products in Macy’s sale and discount selection, for example true.", "examples": [ true ] } }, "additionalProperties": false, "examples": [ { "query": "women's winter coat", "max_results": 5 }, { "sort": "price_low_to_high", "query": "boots", "max_price": 150, "min_price": 100, "max_results": 6, "on_sale_only": true }, { "query": "zzzzxxnomatch87652534", "max_results": 4 } ] } ``` **Output** | Field | Type | Example | Description | |---|---|---|---| | `products` | array | | | | `products[].brand` | string or null | `"DKNY"` | | | `products[].price` | number or null | `149.99` | Current displayed USD price. | | `products[].colours` | array | | | | `products[].image_link` | string or null | `"https://slimages.macysassets.com/is/image/MCY/products/1/optimized/37895501_fpx.tif?qlt=80,0&resMode=sharp2&op_usm=1.75` | | | `products[].product_id` | string | `"26591977"` | | | `products[].star_rating` | number or null | `4.5` | | | `products[].product_link` | string | `"https://www.macys.com/shop/product/dkny-womens-walker-length-puffer-with-faux-fur-trimmed-hood-coat?ID=26591977&isDlp=t` | | | `products[].product_name` | string | `"Women's Walker Length Puffer with Faux Fur Trimmed Hood Coat"` | | | `products[].review_count` | integer or null | `2552` | | | `products[].currency_code` | string | `"USD"` | | | `products[].original_price` | number or null | `285` | Original USD price when shown. | | `products[].discount_percent` | number or null | `47` | | **Example input** ```json { "query": "women's winter coat", "max_results": 5 } ``` **Example output** ```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 } ] } ``` ## Quick start Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys). ```bash # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' : "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}" curl 'https://api.fous.com/v1/query' \ --fail-with-body --silent --show-error --max-time 120 \ -H "Authorization: Bearer $FOUS_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" } }' ``` ```python # Save as fous.py and run with python3 fous.py. No packages needed. # First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' import json import os import urllib.error import urllib.request api_key = os.environ.get("FOUS_API_KEY") if not api_key: raise RuntimeError("Set FOUS_API_KEY before running this example") body = json.loads("{\n \"api\": \"@macys\",\n \"visibility\": \"public\",\n \"operation\": \"search_products\",\n \"version\": 1,\n \"input\": {\n \"query\": \"women's winter coat\",\n \"max_results\": 5\n },\n \"response\": {\n \"format\": \"json\"\n }\n}") request = urllib.request.Request( "https://api.fous.com/v1/query", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": f"Bearer {api_key}", "Content-Type": "application/json", }, method="POST", ) try: with urllib.request.urlopen(request, timeout=120) as response: result = json.load(response) except urllib.error.HTTPError as error: raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error if result.get("success") is False: raise RuntimeError(result.get("error", {}).get("message", "Request failed")) print(json.dumps(result["data"]["output"], indent=2)) ``` ```typescript // Save as fous.mts and run with npx tsx fous.mts. // First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY' const apiKey = process.env.FOUS_API_KEY; if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example"); const response = await fetch("https://api.fous.com/v1/query", { method: "POST", headers: { "Authorization": `Bearer ${apiKey}`, "Content-Type": "application/json", }, signal: AbortSignal.timeout(120_000), body: JSON.stringify({ "api": "@macys", "visibility": "public", "operation": "search_products", "version": 1, "input": { "query": "women's winter coat", "max_results": 5 }, "response": { "format": "json" } }), }); type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } }; const result: ApiResult = await response.json(); if (!response.ok || result.success === false) { throw new Error(result.error?.message ?? `HTTP ${response.status}`); } if (!result.data) throw new Error("Missing API response data"); console.log(result.data.output); ``` Or describe the data in plain language: send `{"api":"@macys","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same. ## Use cases - Find products matching a shopping query - Compare displayed prices across products - Review product ratings and review counts - Find sale products within a price range ## FAQ ### Is Fous affiliated with Macy's? No. Fous is not affiliated with Macy's. This workflow reads the public macys.com website and returns its data. ### How much does it cost? Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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. ## Related - [Nordstrom API](https://fous.com/workflows/nordstrom.md): Search clothing, shoes, and beauty products at Nordstrom. - [Kohl's API](https://fous.com/workflows/kohls.md): Shop products and deals on Kohl's. - [Walmart API](https://fous.com/workflows/walmart.md): Walmart helps shoppers find products from Walmart and marketplace sellers, view details, prices, ratings and reviews; availability uses Walmart’s default location, not ZIP codes. - [Sephora API](https://fous.com/workflows/sephora.md): Sephora provides US beauty products, shopping information, product details, and customer reviews; prices and availability may change. - [Best Buy API](https://fous.com/workflows/best-buy.md): Best Buy returns US electronics and appliance listings, prices, deals, specifications, images, reviews, and nearby store pickup and shipping details; prices and availability can change by location and before checkout. - [Ulta Beauty API](https://fous.com/workflows/ulta-beauty.md): Ulta Beauty returns searchable beauty products and product details, including current pricing and availability that may change. - [H&M API](https://fous.com/workflows/hm.md): H&M offers clothing and home shopping, with country-specific prices and online size stock; product details reflect current catalog information. - [Amazon API](https://fous.com/workflows/amazon.md): Amazon returns publicly shown product listings, prices, details, ratings, reviews, current best sellers, and Today's Deals; availability and content vary by store, location, and access. - [All Commerce workflows](https://fous.com/workflows/category/commerce)