Fresha Scraper - Salon & Spa Data Extractor

Extract salon, spa, and beauty service data from Fresha.com - the world's largest booking platform for beauty and wellness services.

Works worldwide: UAE, UK, USA, Europe, Asia, and anywhere Fresha operates.

Quick Start Examples

Example 1: Scrape a Single Venue (Dubai)

Get complete details for a specific salon including services, prices, reviews, and team.

{
  "mode": "venue",
  "venueUrls": ["https://www.fresha.com/a/chaps-co-jlt-dubai-jumeirah-lake-towers-cluster-c-ejjqnccs"],
  "includeReviews": true,
  "maxReviews": 5
}

Result: Chaps & Co JLT - 62 services, 4.9 rating, full price list

---

Example 2: Search an Area (Dubai Marina)

Find all salons within 5km of Dubai Marina.

{
  "mode": "search",
  "searchLocation": "Dubai Marina",
  "searchRadius": 5,
  "maxSearchResults": 50
}

Result: ~1000 venues found in Dubai Marina area

---

Example 3: Scrape a Single Venue (London)

Get complete details for a Soho salon.

{
  "mode": "venue",
  "venueUrls": ["https://www.fresha.com/a/salon64-london-14-bateman-street-greater-avk70c5j"],
  "includeReviews": true,
  "maxReviews": 5
}

Result: SALON64 - 30 services, 5.0 rating, full price list

---

Example 4: Search an Area (Soho, London)

Find all salons within 3km of Soho.

{
  "mode": "search",
  "searchLocation": "Soho, London",
  "searchRadius": 3,
  "maxSearchResults": 100
}

Result: ~3000 venues found in Soho area

---

Example 5: Scrape a Single Venue (New York)

Get complete details for a Manhattan salon.

{
  "mode": "venue",
  "venueUrls": ["https://www.fresha.com/a/nomad-new-york-1165-broadway-hwiyigoq"],
  "includeReviews": true,
  "maxReviews": 5
}

Result: NoMad - 38 services, 5.0 rating, full price list

---

Example 6: Search an Area (Manhattan, New York)

Find all salons within 5km of Manhattan.

{
  "mode": "search",
  "searchLocation": "Manhattan, New York",
  "searchRadius": 5,
  "maxSearchResults": 100
}

Result: ~443 venues found in Manhattan area

---

What Data Can You Extract?

Data Type	Venue Mode	Search Mode
Business name & details	✅	✅
Services with prices	✅ (full list)	❌
Operating hours	✅	❌
Team members & ratings	✅	❌
Customer reviews	✅	❌
Overall rating	✅	✅
Review count	✅	✅
Location/address	✅	✅
Direct booking URL	✅	✅
Packages & offers	✅	❌

---

Mode 1: Venue Scraping (Specific Business)

Best for: Getting complete details about specific salons you already know.

Scrape detailed information from specific Fresha venue pages including all services, prices, team members, reviews, and operating hours.

Step-by-Step Guide

1. Find a venue on Fresha.com - Search for a salon and copy its URL
2. Set mode to "venue" in the input
3. Paste the URL in venueUrls array
4. Run the Actor - Results include full service menu with prices

Example Input

{
  "mode": "venue",
  "venueUrls": [
    "https://www.fresha.com/a/chaps-co-jlt-dubai-jumeirah-lake-towers-cluster-c-ejjqnccs"
  ],
  "outputFormat": "full",
  "includeReviews": true,
  "includeTeam": true,
  "maxReviews": 10
}

Example Output (Full Format)

{
  "venueName": "Chaps & Co - JLT",
  "url": "https://www.fresha.com/a/chaps-co-jlt-dubai-...",
  "description": "Premium barbershop experience...",
  "phone": "+971 4 XXX XXXX",
  "rating": 4.9,
  "reviewsCount": 2500,
  "currency": "AED",
  "priceMin": 50,
  "priceMax": 500,
  "serviceCount": 62,
  "hours": {
    "Monday": ["10:00 AM - 10:00 PM"],
    "Tuesday": ["10:00 AM - 10:00 PM"]
  },
  "categories": [
    {
      "name": "Haircut",
      "services": [
        {
          "name": "Classic Haircut",
          "price": "AED 85",
          "duration": "30 min",
          "priceValue": 85
        }
      ]
    }
  ],
  "team": [
    {
      "name": "Ahmed",
      "role": "Senior Barber",
      "rating": 4.9
    }
  ],
  "reviews": [
    {
      "rating": 5,
      "comment": "Best barbershop in JLT!",
      "author": "John",
      "date": "Jan 20, 2026"
    }
  ]
}

Output Formats

Format	Description	Best For
full	All venue data including raw fields	Data analysis, backup
services_only	Just services and prices	Price comparison
chatbot_optimized	Compact format for AI processing	WhatsApp bots, n8n chatbots

---

Mode 2: Search (By Location)

Best for: Discovering salons in a specific area, neighborhood, or city.

Search for salons and spas by location. Works with cities, neighborhoods, streets, and specific areas worldwide.

Step-by-Step Guide

1. Choose your location - Can be:
   • City: Dubai, London, New York
   • Neighborhood: Dubai Marina, Soho, London, Manhattan
   • Street/Area: Alkhuwair, Muscat, Oxford Street, London
2. Set the search radius - 1-100 km from center point
3. Set max results - Up to 2000 venues
4. Optionally filter by category - Hair, Nails, Spa, etc.
5. Run the Actor - Results include venue list with ratings

Example: Search a Neighborhood

{
  "mode": "search",
  "searchLocation": "Dubai Marina",
  "searchRadius": 5,
  "maxSearchResults": 50
}

Example: Search with Category Filter

{
  "mode": "search",
  "searchLocation": "Soho, London",
  "serviceCategory": "hair-and-styling",
  "searchRadius": 3,
  "maxSearchResults": 100
}

Example Output

{
  "searchQuery": {
    "location": "Dubai Marina - Dubai - United Arab Emirates",
    "serviceCategory": null,
    "extractionMethod": "browser"
  },
  "venues": [
    {
      "name": "Chaps & Co - JLT",
      "slug": "chaps-co-jlt-dubai-...",
      "url": "https://www.fresha.com/a/chaps-co-jlt-dubai-...",
      "rating": 4.9,
      "reviewsCount": 2500,
      "location": "500m • Jumeirah Lake Towers"
    }
  ],
  "scrapedAt": "2026-01-26T05:30:00.000Z"
}

Supported Location Formats

Format	Example	Works?
City	Dubai, London, New York	✅
City, Country	Dubai, UAE, London, UK	✅
Neighborhood	Dubai Marina, Soho, Manhattan	✅
Area, City	Alkhuwair, Muscat, Mayfair, London	✅
Country only	UAE, UK, Oman	✅ (uses capital city)

Available Service Categories

• hair-and-styling - Hair salons
• barbering - Barbershops
• nails - Nail salons
• spa-and-wellness - Spas
• massage - Massage therapy
• facials-and-skincare - Skincare
• eyebrows-and-eyelashes - Brows & lashes
• makeup - Makeup services
• hair-removal - Waxing & hair removal
• body-and-skin - Body treatments
• aesthetics - Aesthetic treatments
• tattoo-and-piercing - Tattoo & piercing
• holistic-health - Holistic treatments
• dental - Dental services
• medical - Medical services
• pets - Pet grooming
• fitness - Fitness services
• physical-therapy - Physical therapy
• counseling-and-therapy - Counseling
• other - Other services

---

Recommended Workflow: Discover Then Scrape

For comprehensive data, use both modes together:

// Step 1: Discover venues in an area
{
  "mode": "search",
  "searchLocation": "Dubai Marina",
  "searchRadius": 5,
  "maxSearchResults": 100
}

// Step 2: Scrape full details for venues you want
{
  "mode": "venue",
  "venueUrls": [
    "https://www.fresha.com/a/venue-1-url",
    "https://www.fresha.com/a/venue-2-url"
  ]
}

---

Input Parameters Reference

Common Parameters

Parameter	Type	Default	Description
mode	string	venue	Scraping mode: venue or search
webhookUrl	string	-	URL to POST results after scraping
proxyConfiguration	object	-	Proxy settings (not required)

Venue Mode Parameters

Parameter	Type	Default	Description
venueUrls	array	-	List of Fresha venue URLs
venueSlug	string	-	Single venue slug (alternative)
includeReviews	boolean	true	Include customer reviews
includeTeam	boolean	true	Include team members
maxReviews	integer	10	Max reviews to include (0 = all)
outputFormat	string	full	Output format

Search Mode Parameters

Parameter	Type	Default	Description
searchLocation	string	-	Location to search (required)
serviceCategory	string	""	Category filter (empty = all)
searchRadius	number	30	Search radius in km (1-100)
maxSearchResults	integer	100	Max venues to return (1-2000)

---

Integration with n8n

Using Official Apify Node

1. Install Apify node in n8n
2. Get API token from Apify Console
3. Configure the node:

Node: Apify
Operation: Run Actor
Actor ID: malikgen/fresha-scraper
Input Body:
{
  "mode": "search",
  "searchLocation": "Dubai Marina",
  "maxSearchResults": 50
}

Using Webhooks (Real-time)

Configure the Actor to POST results directly to n8n:

{
  "mode": "venue",
  "venueUrls": ["https://www.fresha.com/a/..."],
  "webhookUrl": "https://your-n8n.com/webhook/fresha"
}

---

Technical Details

Performance

• Venue mode: ~2-5 seconds per venue (HTTP-only, very fast)
• Search mode: ~30-90 seconds (browser-based)

Proxy Recommendations

No proxy required! Fresha.com works perfectly without any proxy.

Proxy Type	Duration	Cost	Recommendation
No Proxy	~25s	$0.004	✅ Use this
Datacenter	~72s	$0.012	Works but slower
Residential	~119s	$0.042	Not needed

---

Use Cases

1. Price Comparison: Compare service prices across salons
2. Market Research: Analyze ratings and reviews in a region
3. Chatbot Integration: Power WhatsApp/Telegram bots with salon data
4. Lead Generation: Find salons for B2B outreach
5. Competitive Analysis: Monitor competitor pricing
6. Booking Aggregator: Build salon discovery platforms

---

Changelog

v0.1.21 (Current)

• NEW: Neighborhood/Area search support - Search specific areas like "Dubai Marina", "Soho, London", "Manhattan"
• NEW: Geocoding fallback - Uses OpenStreetMap Nominatim when Fresha API doesn't return coordinates
• IMPROVED: Country-only searches now use capital city coordinates (e.g., "Oman" → Muscat coords)
• GLOBAL: Works worldwide - Tested in UAE, UK, USA, and more
• UPDATED: Input schema with clearer location guidance
• UPDATED: README with 6 comprehensive examples (UAE, London, NYC)

v0.1.20

• Simplified from 3 modes to 2 modes (venue + search)
• Added "All Categories" option for comprehensive discovery
• Updated category dropdown with clear descriptions

v0.1.18

• Fixed search mode to collect 90+ venues instead of 4-6
• Implemented incremental scroll-and-collect strategy
• Confirmed no proxy required

v0.1.0

• Initial release with venue and search modes
• GCC region geolocation support
• Webhook integration for n8n