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

{
  "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

{
  "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

{
  "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:

{
  "latitude": "40.1548235",
  "longitude": "-8.4293891",
  "countryCode": "PT"
}

With Language Specification

Search for stores in Spain with Spanish language:

{
  "latitude": "40.4168",
  "longitude": "-3.7038",
  "countryCode": "ES",
  "languageCode": "es"
}

International Location

Search for stores in Dubai, UAE:

{
  "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.

---