Starbucks Store Locator Actor

Overview

This Apify Actor scrapes Starbucks store locations using Playwright with advanced data extraction capabilities. It searches for Starbucks stores by location name and extracts comprehensive store information including store IDs and coordinates.

Features

• Location-based Search: Search for Starbucks stores by location name (e.g., "New York, NY, USA")
• Comprehensive Data Extraction: Extracts store names, addresses, distances, store IDs, and coordinates
• Proxy Support: Built-in support for Apify Proxy with residential IPs
• Interactive Data Collection: Clicks on store cards to extract detailed information
• Robust Error Handling: Advanced error handling and retry mechanisms

Input Parameters

• place: Location name for search (default: "New York, NY, USA")
• proxyConfiguration: Proxy settings for web scraping

Output Schema

The Actor outputs detailed store information in the following JSON schema:

{
    "type": "object",
    "properties": {
        "storeId": {
            "type": ["string", "null"],
            "description": "Unique identifier for the store (may be null if not available)"
        },
        "storeName": {
            "type": "string",
            "description": "Name of the Starbucks location"
        },
        "address": {
            "type": "string",
            "description": "Full street address of the store"
        },
        "distance": {
            "type": "string",
            "description": "Distance from the search location (e.g., '0.3 miles away')"
        },
        "coordinates": {
            "type": ["object", "null"],
            "description": "Latitude and longitude coordinates",
            "properties": {
                "lat": {
                    "type": "number",
                    "description": "Latitude coordinate"
                },
                "lng": {
                    "type": "number",
                    "description": "Longitude coordinate"
                }
            }
        },
        "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "ISO 8601 timestamp when the data was extracted"
        }
    },
    "required": ["storeName", "address", "distance", "timestamp"]
}

Example Output

{
    "storeId": null,
    "storeName": "DTLA Grand Park",
    "address": "217 N. Hill Street, Los Angeles",
    "distance": "0.3 miles away",
    "coordinates": null,
    "timestamp": "2024-01-15T10:30:00.000Z"
}

Output Fields

• storeId: Unique identifier for the store (may be null if not available)
• storeName: Name of the Starbucks location
• address: Full street address
• distance: Distance from the search location
• coordinates: Latitude and longitude coordinates (may be null if not available)
• timestamp: ISO 8601 timestamp when the data was extracted

Technical Details

• Browser: Chrome-based Playwright
• Proxy: Apify Proxy with residential IPs
• Timeout: 60 seconds for page loads
• Max Stores: 50 stores per search
• Data Source: Starbucks Store Locator (https://www.starbucks.com/store-locator)

⚠️ Important Notes

1. Respect Starbucks' Terms of Service - Use this Actor responsibly and in accordance with Starbucks' policies
2. Rate Limiting - The Actor includes built-in delays to avoid overwhelming Starbucks' servers
3. Proxy Usage - For large-scale scraping, always use residential proxies
4. Data Usage - Ensure you have permission to use scraped data for your intended purpose
5. Public Information Only - The Actor can only access publicly available store location data

Usage

The Actor navigates to the Starbucks store locator, searches for the specified location, and extracts store information by clicking on each store card to access detailed data including store IDs and coordinates.