Booksy Scraper

Scrape Booksy — the world's leading beauty appointment booking platform with 35M+ users across 150+ countries. Extract salon, barber, nail studio, spa, and other beauty business data including ratings, reviews, services, staff, location, and booking availability.

What data can you extract?

Each business record includes:

Field	Description
businessId	Unique Booksy business identifier
name	Business name
slug	URL slug
profileUrl	Full Booksy profile URL
address	Full street address
city	City
latitude / longitude	GPS coordinates
rating	Average rating (0–5 scale)
reviewCount	Total number of reviews
starRating	Star rating (1–5)
category	Primary service category (e.g. "hair", "nails")
categoryId	Booksy category ID
serviceCategories	All service categories offered
staff	List of staff member names
description	Business description / bio
website	Business website URL
facebookUrl	Facebook page URL
instagramUrl	Instagram profile URL
ecommerceUrl	Business's online shop / e-commerce URL (when available)
bookingEnabled	Whether online booking is available
isRecommended	Booksy recommended badge
bestOfBooksyBadge	Best of Booksy award winner
isMobileService	Mobile/traveling service
pricingLevel	Pricing tier (1=budget, 4=luxury)
distanceKm	Straight-line distance from the search location (km), calculated from GPS coordinates
amenities	Available amenities (parking, WiFi, etc.)
topServices	Most popular services
imageUrl	Cover photo URL
logoUrl	Logo image URL
openHours	Opening hours by day
isPromoted	Whether the business has a paid "Promoted" placement
maxDiscountRate	Maximum active discount rate (%) across services, 0 if none
hasLowAvailability	Whether Booksy flags the business as having low booking availability
offersVirtualServices	Whether the business offers online/virtual services
offersOnlineVouchers	Whether the business sells online vouchers/gift certificates
acceptsBooksyGiftCards	Whether the business accepts Booksy gift cards
acceptsBooksyPay	Whether the business accepts Booksy Pay
state	State/region (byBusinessId mode only)
zipCode	ZIP/postal code (byBusinessId mode only)
bookingPolicy	Cancellation/change policy text, e.g. "Changes allowed up to 2 hours before visit" (byBusinessId mode only)
bookingLeadTimeDays	How many days in advance you can book (byBusinessId mode only)
topReviews	Up to a few recent written reviews with text, rating, reviewer name, date, and service (byBusinessId mode only)
sourceUrl	Booksy search URL used
scrapedAt	UTC timestamp of scrape
recordType	Always "business"

Modes

Search mode (default)

Search for businesses by keyword near a location.

{
  "mode": "search",
  "searchQuery": "hair salon",
  "location": "New York",
  "maxItems": 50
}

By Category mode

Browse all businesses in a specific service category.

{
  "mode": "byCategory",
  "category": "nails",
  "location": "Los Angeles",
  "maxItems": 100
}

Available categories: hair, barber, nails, skin-care, brows-and-lashes, massage, makeup, wellness-and-spa, braids-and-locs, tattoos, medical-aesthetics, hair-removal, home-services, piercing, pet-services, dental, health-and-fitness, professional-services, other

By Business ID mode

Fetch detailed information for specific Booksy businesses.

{
  "mode": "byBusinessId",
  "businessIds": ["688238", "1439833"]
}

Input Options

Parameter	Type	Description
mode	string	search, byCategory, or byBusinessId
searchQuery	string	Keyword to search (search mode)
location	string	City name for location search
latitude	number	GPS latitude (overrides location)
longitude	number	GPS longitude (overrides location)
radiusKm	integer	Search radius hint in km sent to Booksy (default: 10). Booksy's own search may still surface businesses outside this radius when local inventory is thin — the same behavior you'll see searching directly on booksy.com. Use the returned distanceKm field to filter/sort results by actual distance if you need a strict radius.
category	string	Category slug (byCategory mode)
businessIds	array	Business IDs (byBusinessId mode)
minRating	number	Minimum rating filter (0–5)
maxRating	number	Maximum rating filter (0–5)
minReviewCount	integer	Minimum review count filter
filterCategory	string	Category filter for search results
isRecommended	boolean	Filter to recommended businesses only
maxItems	integer	Maximum records to return (default: 50)

Sample Output

{
  "businessId": "1439833",
  "name": "Idamaris Hair Salon",
  "profileUrl": "https://booksy.com/en-us/1439833_idamaris-hair-salon_hair-salon_34846_providence",
  "address": "921 Chalkstone Ave, Providence, 02908",
  "city": "Providence",
  "latitude": 41.833,
  "longitude": -71.438,
  "rating": 4.73,
  "reviewCount": 30,
  "category": "hair",
  "categoryId": 1,
  "isRecommended": true,
  "bookingEnabled": true,
  "sourceUrl": "https://booksy.com/en-us/s/hair-salon",
  "scrapedAt": "2026-06-30T12:00:00+00:00",
  "recordType": "business"
}

Use Cases

• Lead generation — Find beauty businesses by city and service type for B2B outreach
• Competitive analysis — Compare ratings and services across salons in a market
• Market research — Analyze pricing levels and service availability by geography
• Booking aggregation — Build city guides for beauty services
• Reputation monitoring — Track ratings and review counts over time

FAQs

Does this require a Booksy account? No. The scraper uses Booksy's public search API — no login or account required.

What countries does Booksy cover? Booksy operates in 150+ countries. This actor targets the US market (us.booksy.com) but the approach can be extended.

How many businesses can I scrape? Booksy shows up to 10,000 businesses per search. Set maxItems up to 1,000 per run.

How fresh is the data? Data is scraped in real-time directly from Booksy's API.

Are reviews included? Review counts, average rating, and star rating are included in every mode. Individual written reviews (topReviews — text, rating, reviewer name, date, service) are only available in byBusinessId mode, which also returns additional business profile details (description, staff, top services, amenities, booking policy, state/ZIP).

Will results always be within my specified radius? radiusKm is passed to Booksy as a search hint, not a hard filter — Booksy's own search (including on booksy.com) can surface businesses outside the requested radius when local matches are limited. Each business record includes a real distanceKm (great-circle distance computed from GPS coordinates), so you can filter or sort post-scrape if you need a strict radius.