Macy's Product Search Scraper Actor Documentation

Overview

The Macy's Product Search Scraper is a reliable tool to extract product data directly from Macy's search results. Whether you're conducting market research, tracking pricing trends, or building a product database, this actor provides comprehensive product information in an easy-to-use format.

---

Features

• Flexible Search Queries: Search for products using any keyword or term.
• Paginated Results: Retrieve data across multiple pages with adjustable limits per page.
• Region and Currency Support: Customize results for specific regions and currencies.
• Comprehensive Data Extraction: Get details like product names, prices, descriptions, and more.

---

Use Cases

• Market Research: Analyze Macy's product offerings for insights and trends.
• Price Monitoring: Track product prices and promotions in real time.
• Competitor Analysis: Compare Macy's product catalog with other retailers.
• E-commerce Development: Populate your store or tool with Macy's product data.

---

Input Parameters

The actor accepts the following input parameters:

Parameter Name	Type	Default Value	Description
query	String	hat	The search term to query Macy's product catalog.
currencyCode	String	USD	The currency code for product prices (e.g., USD, EUR).
regionCode	String	US	The region code for localized results.
page	String	1	The page number of the search results to scrape.
perPage	String	20	The number of products to retrieve per page (e.g., 20, 50).

Example Input

1const {
2  query = 'hat',
3  currencyCode = 'USD',
4  regionCode = 'US',
5  page = '1',
6  perPage = '20'
7} = input;

---

Output

The actor outputs product search results in JSON format.

Example Output

1{
2  "result": [
3    {
4      "product": {
5        "id": 995170,
6        "identifier": {
7          "productUrl": "/shop/product/country-gentleman-hats-wilton-wool-fedora?ID=995170&isDlp=true",
8          "productId": 995170
9        },
10        "detail": {
11          "name": "Country Gentleman Hats, Wilton Wool Fedora",
12          "brand": "Country Gentlemen",
13          "flags": {
14            "registrable": true,
15            "isStoreOnlyProductOnline": true,
16            "hasColors": true,
17            "PDPColorized": true
18          },
19          "reviewStatistics": {
20            "aggregate": {
21              "rating": 4.5872,
22              "count": 109
23            }
24          },
25          "typeName": "HAT"
26        },
27        "relationships": {
28          "taxonomy": {
29            "defaultCategoryId": 176642
30          }
31        },
32        "imagery": {
33          "additionalImageSource": [
34            {
35              "filePath": "8/optimized/2992088_fpx.tif"
36            }
37          ],
38          "primaryImage": {
39            "filePath": "8/optimized/2992088_fpx.tif"
40          }
41        },
42        "availability": {
43          "active": true,
44          "available": true
45        },
46        "traits": {
47          "colors": {
48            "selectedColor": {
49              "id": 1002299,
50              "name": "Brown",
51              "normalName": "Brown",
52              "swatchImage": {
53                "filePath": "4/optimized/1215114_fpx.tif"
54              },
55              "imagery": {
56                "additionalImageSource": [
57                  {
58                    "filePath": "8/optimized/2992088_fpx.tif"
59                  }
60                ],
61                "primaryImage": {
62                  "filePath": "8/optimized/2992088_fpx.tif"
63                }
64              }
65            },
66            "colorMap": [
67              {
68                "id": 1002264,
69                "name": "Black",
70                "normalName": "Black",
71                "swatchImage": {
72                  "filePath": "7/optimized/3193337_fpx.tif"
73                },
74                "imagery": {
75                  "additionalImageSource": [
76                    {
77                      "filePath": "8/optimized/2975658_fpx.tif"
78                    }
79                  ],
80                  "primaryImage": {
81                    "filePath": "8/optimized/2975658_fpx.tif"
82                  }
83                }
84              },
85              {
86                "id": 1002299,
87                "name": "Brown",
88                "normalName": "Brown",
89                "swatchImage": {
90                  "filePath": "4/optimized/1215114_fpx.tif"
91                },
92                "imagery": {
93                  "additionalImageSource": [
94                    {
95                      "filePath": "8/optimized/2992088_fpx.tif"
96                    }
97                  ],
98                  "primaryImage": {
99                    "filePath": "8/optimized/2992088_fpx.tif"
100                  }
101                }
102              }
103            ]
104          },
105          "types": {}
106        },
107        "pricing": {
108          "price": {
109            "priceType": {
110              "applicableToAllUpcs": true
111            },
112            "tieredPrice": [
113              {
114                "label": "[PRICE]",
115                "values": [
116                  {
117                    "value": 79,
118                    "formattedValue": "$79.00",
119                    "type": "regular"
120                  }
121                ]
122              }
123            ],
124            "priceTypeId": 11
125          }
126        },
127        "mltUrlPath": "/shop/similar-products?&CategoryID=176642&imageId=2992088&productId=995170&cm_sp=MLT_RESP-_-pros-_-2992088-995170&modelId=pros&lid=more_like_this-pros-2992088-995170&productType=HAT",
128        "assetAnalytics": "MLT_RESP-_-pros-_-2992088-995170"
129      }
130    },
131    // others products
132      ]
133}

Key Fields

• query: The input search term.
• currencyCode: The currency used in the prices.
• regionCode: The region for localized results.
• page: The current page number of the results.
• products: An array of product details, including:
  • name: Product name.
  • price: Product price in the specified currency.
  • currency: The currency code for the price.
  • imageUrl: URL of the product image.
  • productUrl: URL of the product page on Macy's.
  • brand: Brand name of the product.
  • availability: Stock availability status.

---

How to Use

1. Set Up the Input:
   Customize the parameters (query, currencyCode, regionCode, page, and perPage) as needed.

2. Run the Actor:
   Start the actor to retrieve search results for the specified parameters.

3. Retrieve the Output:
   Access the JSON output for detailed product data.

---

SEO Benefits

Using the Macy's Product Search Scraper can boost your e-commerce or affiliate strategy by:

• Content Enrichment: Add product details and images to enhance your site’s offerings.
• Trend Tracking: Monitor popular products and optimize for relevant keywords.
• Affiliate Marketing: Populate product catalogs with Macy's data to drive traffic and conversions.

---

Limitations

• Region-Specific Results: Ensure the regionCode matches Macy's supported regions for accurate data.
• Pagination Limits: Excessive pagination may impact scraping speed; optimize perPage values accordingly.

---

Pricing

The Macy's Product Search Scraper is available on Apify with flexible pricing plans. Try it now with the 1-day free trial to experience its capabilities.

---

FAQs

Q1: Can I scrape products in bulk?
A: Yes, you can adjust the page and perPage parameters to retrieve multiple products.

Q2: Does the actor work for international regions?
A: Yes, you can set the regionCode and currencyCode to retrieve region-specific data.

Q3: Can I scrape promotions and discounts?
A: The actor captures the product prices as displayed, including discounts if available.

---

Start leveraging the Macy's Product Search Scraper to explore products, analyze trends, and grow your business! 🚀