Macy's Products Actor

Overview

This Apify actor scrapes detailed product information from Macy's e-commerce website. It processes multiple product URLs by calling Macy's internal API and returns structured data.

Key Features

• Bulk processing: Handles multiple product URLs in a single run.
• API-based: Uses Macy's internal API for reliable data extraction.
• Configurable: Supports optional currency (USD, CAD, EUR) and region (US, CA, UK) codes.
• Structured output: Returns consistent JSON data for each product.
• Robust error handling: Manages invalid URLs, network issues, and API rate limits.

Input

The actor requires an array of product URLs. Currency and region are optional.

Input Schema:

{
  "productUrls": [
    { "url": "https://www.macys.com/shop/product/..." },
    { "url": "https://www.macys.com/shop/product/..." }
  ],
  "currencyCode": "USD", // Optional, defaults to "USD"
  "regionCode": "US"     // Optional, defaults to "US"
}

Output

Results are provided in two formats:
1. Dataset: Each product is pushed as an individual record via Actor.pushData().
2. Key-Value Store: All results are compiled into a single array stored under the key 'output'.

The output includes product name, description, pricing, images, availability, specifications, reviews, and category info.

How to Use

Run via Apify Console:
1. Navigate to the actor in your Apify account.
2. Configure the input JSON.
3. Click "Start".

Run via API:

const { ApifyApi } = require('apify-client');
const client = new ApifyApi({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('THE_ACTOR_ID').call({
  productUrls: [ { url: "https://www.macys.com/shop/product/..." } ],
  currencyCode: "USD",
  regionCode: "US"
});

Accessing Results:
* Fetch individual records from the run's dataset.
* Retrieve the complete array from the key-value store using the key 'output'.
* Use Apify's standard API endpoints for dataset and key-value store results.

Best Practices & Limitations

Best Practices:
* Use valid, full Macy's product URLs including all query parameters.
* Process products in reasonable batch sizes to manage performance.
* Validate output data for completeness.

Limitations:
* Subject to Macy's API rate limiting.
* Product availability and data may change between runs.
* Some products may have regional restrictions.
* Dependent on Macy's current URL structure and API stability.