Lefties Stores By Proximity Actor ## Overview The Lefties Stores By Proximity Actor is an Apify actor that searches for Lefties store locations based on geographic coordinates (latitude and longitude). This actor retrieves detailed information about nearby Lefties stores, including their addresses, opening hours, contact information, and available services. ## Features - Find Lefties stores near specific coordinates - Support for multiple countries and regions - Detailed store information including opening hours, contact details, and services - Multi-language support - JSON output with comprehensive store data ## Input Parameters ### Required Parameters | Parameter | Type | Description | Example | |-----------|------|-------------|---------| | latitude | string | The latitude coordinate to search from | "40.1548235" | | longitude | string | The longitude coordinate to search from | "-8.4293891" | ### Optional Parameters | Parameter | Type | Description | Default | Options | |-----------|------|-------------|---------|---------| | countryCode | string | Two-letter country code for Lefties regional site | "ES" | See supported countries below | | languageCode | string | Language code for returned information | null | Country-specific language codes | ### Supported Countries The actor supports the following countries and regions: | Code | Country/Region | |------|----------------| | AD | Andorra | | AE | UAE | | BH | Bahrain | | EG | Egypt | | ES | Spain | | IC | Canary Islands | | IL | Israel | | IT | Italy | | JO | Jordan | | KW | Kuwait | | MA | Morocco | | MX | Mexico | | OM | Oman | | PT | Portugal | | QA | Qatar | | RO | Romania | | SA | Saudi Arabia | | TN | Tunisia | | TR | Turkey | | XE | Ceuta and Melilla | ## Input Schema Example json { "latitude": "40.1548235", "longitude": "-8.4293891", "countryCode": "ES", "languageCode": "es" } ## Output Format The actor returns a JSON object containing detailed information about nearby Lefties stores. The output includes: ### Main Output Structure json { "results": { "lastUsedStores": [], "favouriteStores": [], "closerStores": [ // Array of store objects ] }, "completedAt": "2025-06-12T10:46:57.004Z" } ### Store Object Properties Each store in the closerStores array contains the following information: #### Basic Information - id: Unique store identifier - name: Store name - countryName: Country name - countryCode: Two-letter country code - state: State/province name - stateCode: State/province code - city: City name - zipCode: Postal code - area: Store area in square meters - photo: Store photo URL (if available) #### Location & Contact - latitude: Store latitude coordinate - longitude: Store longitude coordinate - addressLines: Array of address lines - phones: Array of phone numbers - url: Store's webpage URL #### Operating Hours - openingHours: Regular operating schedule - schedule: Array of weekly schedules - weekdays: Days of the week (1=Monday, 7=Sunday) - timeStripList: Opening and closing times - openHoliday: Special holiday hours - closeHoliday: Holiday closures - nextOpeningDays: Upcoming week's schedule with specific dates - timezone: Store's timezone #### Store Features & Services - sections: Available store sections - idStoreType: Store type ID - nameStoreType: Store type name (e.g., "CENTRO COMERCIAL", "CALLE") - isPickupAllowed: Whether pickup orders are allowed - receiveBooking: Booking availability - receiveStockQuery: Stock query availability - physicalStoreState: Current store state (e.g., "OPEN") - storeServices: Array of available services - additionalServices: Additional service offerings ## Example Output json { "results": { "lastUsedStores": [], "favouriteStores": [], "closerStores": [ { "id": "16769", "name": "EL FARO DEL GUADIANA", "countryName": "ESPAÑA", "countryCode": "ES", "state": "BADAJOZ", "stateCode": "ESBA", "city": "BADAJOZ", "zipCode": "06006", "area": 6666.01, "latitude": 38.88385, "longitude": -7.021894, "addressLines": ["DE ELVAS, S/N"], "phones": ["+34 924177322"], "url": "https://www.lefties.com/es/store-locator/badajoz/de-elvas-s/n-s16769.html", "openingHours": { "schedule": [ { "weekdays": [1, 2, 3, 4, 5, 6, 7], "timeStripList": [ { "initHour": "10:00", "endHour": "22:00" } ] } ] }, "idStoreType": 2, "nameStoreType": "CENTRO COMERCIAL", "isPickupAllowed": true, "physicalStoreState": "OPEN", "timezone": "Europe/Madrid" } ] }, "completedAt": "2025-06-12T10:46:57.004Z" } ## Usage Examples ### Basic Usage Search for stores near Coimbra, Portugal: json { "latitude": "40.1548235", "longitude": "-8.4293891", "countryCode": "PT" } ### With Language Specification Search for stores in Spain with Spanish language: json { "latitude": "40.4168", "longitude": "-3.7038", "countryCode": "ES", "languageCode": "es" } ### International Location Search for stores in Dubai, UAE: json { "latitude": "25.2048", "longitude": "55.2708", "countryCode": "AE" } ## Data Storage The actor stores results in two ways: 1. Dataset: Individual store records are pushed to the default dataset 2. Key-Value Store: Complete results with metadata are saved under the key 'output' ## Error Handling The actor includes comprehensive error handling: - Validates required input parameters - Provides meaningful error messages for missing or invalid inputs - Logs search progress and results - Handles API failures gracefully ## Use Cases - Store Locator Applications: Build store finder features for mobile apps or websites - Market Research: Analyze Lefties store distribution and coverage - Location Analytics: Study store density and geographic patterns - Customer Service: Help customers find nearby stores with current information - Business Intelligence: Track store operations and availability ## Rate Limits & Best Practices - Use reasonable geographic coordinates within supported countries - Consider caching results for frequently queried locations - Respect the service's rate limits by spacing requests appropriately - Use appropriate country codes for better results accuracy This actor provides a reliable way to access current Lefties store information based on geographic proximity, making it ideal for location-based applications and services. ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Apify Platform: You can also contact us directly through this platform. ---