Macys Store By Proximity - Apify Actor Documentation

Overview

Macys Store By Proximity is a powerful Apify actor that helps you find the nearest Macy's department store location based on geographic coordinates. This actor uses Macy's official store locator API to retrieve detailed information about the closest store within a specified radius, making it perfect for location-based applications, retail analytics, and customer service tools.

🚀 Quick Start

Input Parameters

The actor requires three essential parameters:

Parameter	Type	Required	Default	Description
latitude	String	Yes	40.7500	Latitude coordinate (decimal degrees)
longitude	String	Yes	-73.9967	Longitude coordinate (decimal degrees)
radius	String	Yes	M100	Search radius (format: M + number in miles)

Example Input

{
  "latitude": "40.7500",
  "longitude": "-73.9967",
  "radius": "M100"
}

Example Output

The actor returns comprehensive store information including:

{
  "preferredStore": {
    "storeId": "70",
    "storeNumber": "3",
    "locationNumber": "10",
    "divisionId": "6",
    "name": "Macy's Herald Square",
    "address": {
      "id": "70",
      "line1": "151 West 34th Street",
      "line2": "",
      "city": "New York",
      "state": "NY",
      "zipCode": "10001",
      "countryCode": "USA"
    },
    "phoneNumber": "212-695-4400",
    "geoLocation": {
      "latitude": "40.751455",
      "longitude": "-73.9902",
      "distance": "0.3951",
      "distanceUnit": "mi"
    },
    "schedule": {
      "todaysHours": {
        "openTime": "10:00 am",
        "closeTime": "10:00 pm"
      },
      "tomorrowsHours": {
        "openTime": "10:00 am",
        "closeTime": "10:00 pm"
      }
    }
  }
}

📍 Use Cases

1. E-commerce Integration

• Store Locator Features: Integrate into websites to help customers find nearby Macy's locations
• Click-and-Collect Services: Enable customers to choose pickup locations based on proximity
• Inventory Management: Check which stores are closest to customers for efficient order fulfillment

2. Marketing & Analytics

• Geo-targeted Campaigns: Create location-specific marketing campaigns based on store proximity
• Market Analysis: Analyze store coverage and identify market gaps
• Customer Demographics: Map customer locations relative to store positions

3. Mobile Applications

• Location-based Services: Build mobile apps that automatically suggest the nearest Macy's store
• Navigation Integration: Provide turn-by-turn directions to the closest store
• Store Hours Display: Show real-time opening hours for nearby locations

4. Business Intelligence

• Competitor Analysis: Map Macy's store locations for market research
• Site Selection: Analyze existing store coverage for new location planning
• Supply Chain Optimization: Optimize delivery routes based on store locations

5. Customer Service Tools

• Call Center Support: Help customer service representatives quickly find store information
• Live Chat Integration: Automatically suggest nearby stores during customer inquiries
• Appointment Scheduling: Connect customers with services at their nearest location

🛠 Technical Implementation

API Integration

This actor seamlessly integrates with Macy's official store locator system, ensuring:

• Real-time Data: Always current store information and hours
• Reliable Performance: Built-in request delays prevent rate limiting
• Error Handling: Comprehensive validation and error management

Rate Limiting

The actor includes intelligent rate limiting with random delays (0-0.5 seconds) between requests to ensure stable performance and compliance with API guidelines.

Data Quality

Each response includes:

• Complete store contact information
• Precise geographic coordinates with calculated distance
• Current and next-day operating hours
• Store hierarchy information (division, location numbers)

🔧 Configuration Guide

Basic Setup

1. Input Coordinates: Use decimal degree format for latitude and longitude
2. Set Radius: Specify search radius using "M" prefix (e.g., "M50" for 50 miles)
3. Run Actor: Execute to retrieve the nearest store information

Advanced Configuration

• Multiple Locations: Run the actor multiple times with different coordinates for batch processing
• Custom Radius: Adjust radius based on your specific use case (urban vs. rural areas)
• Integration: Use Apify SDK or API to integrate into your applications

📊 Output Data Structure

The actor returns structured JSON data containing:

Store Information

• Identifiers: Store ID, number, location number, division ID
• Basic Details: Store name and complete address
• Contact: Phone number for customer inquiries

Geographic Data

• Coordinates: Precise latitude and longitude
• Distance: Calculated distance from input coordinates
• Units: Distance measurement unit (miles)

Operating Hours

• Today's Schedule: Current day opening and closing times
• Tomorrow's Schedule: Next day operating hours for planning

🌟 Why Choose This Actor?

✅ Accurate & Reliable

• Uses official Macy's API for guaranteed accuracy
• Real-time store information and hours
• Robust error handling and validation

✅ Easy Integration

• Simple JSON input/output format
• Compatible with all major programming languages
• Comprehensive documentation and examples

✅ Cost-Effective

• Pay-per-use pricing model
• No setup fees or monthly subscriptions
• Efficient processing with minimal compute usage

✅ Developer-Friendly

• Clean, structured data output
• RESTful API compatibility
• Extensive use case examples

🚀 Getting Started

1. Sign up for an Apify account
2. Find the "Macys Store By Proximity" actor in the Apify Store
3. Configure your input parameters (latitude, longitude, radius)
4. Run the actor and retrieve your store data
5. Integrate the results into your application

💡 Pro Tips

• Optimize Radius: Use smaller radius values in dense urban areas, larger ones in rural areas
• Cache Results: Store results temporarily to reduce API calls for repeated queries
• Batch Processing: Process multiple locations efficiently by running the actor in sequence
• Error Handling: Always check for successful responses before processing data

🆘 Support & Troubleshooting

Common Issues

• Invalid Coordinates: Ensure latitude/longitude are in decimal degree format
• Radius Format: Use "M" prefix followed by number (e.g., "M100")
• No Results: Try increasing radius if no stores found in specified area

Error Messages

• Please provide the latitude parameter: Latitude input is missing or invalid
• Please provide the longitude parameter: Longitude input is missing or invalid
• Please provide the radius parameter: Radius input is missing or invalid

📈 SEO Keywords

Macy's store locator, department store finder, retail location API, store proximity search, Macy's near me, retail analytics, location-based services, store hours API, geographic store search, retail automation, e-commerce integration, store locator tool, Macy's API, retail data extraction, location intelligence

---

For additional support, refer to the Apify documentation or contact us.