{
  "data": {
    "id": "l7TUxPwUg19UFth7m",
    "actId": "pGKCI2CpElhMoLmV4",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-18T18:34:41.753Z",
    "finishedAt": "2026-11-18T18:34:52.972Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 11137,
      "runTimeSecs": 11.137,
      "computeUnits": 0.012374444444444445,
      "imageSizeBytes": 358461440
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Booksy Beauty & Wellness Business Profile Scraper Input\",\n  \"description\": \"Search Booksy businesses by keyword, browse a category, look up business IDs or profile URLs, or export reviews across 17 Booksy markets.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to scrape.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byCategory\",\n        \"byBusinessId\",\n        \"reviews\",\n        \"byUrl\"\n      ],\n      \"enumTitles\": [\n        \"Search — keyword and location\",\n        \"By Category — browse one service category\",\n        \"By Business ID — full profiles for IDs or profile URLs\",\n        \"Reviews — export written reviews for IDs or profile URLs\",\n        \"By URL — paste Booksy search and/or profile links\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"searchQuery\": {\n      \"title\": \"Search query\",\n      \"type\": \"string\",\n      \"description\": \"Keyword to search for (mode=search). Required for search mode; an empty or missing value is rejected instead of falling back to a default. Examples: 'hair salon', 'barber', 'nail salon', 'massage', 'eyebrows'. Use the market's language for non-English countries (e.g. 'fryzjer' in Poland, 'peluqueria' in Spain).\",\n      \"editor\": \"textfield\",\n      \"default\": \"hair salon\",\n      \"prefill\": \"hair salon\"\n    },\n    \"location\": {\n      \"title\": \"Location (city or area)\",\n      \"type\": \"string\",\n      \"description\": \"City or area to search near (modes search, byCategory). Local-language city names work (e.g. 'Warszawa', 'Kraków'). Leave empty to search the whole country. Latitude/longitude override this field.\",\n      \"editor\": \"textfield\",\n      \"default\": \"New York\",\n      \"prefill\": \"New York\"\n    },\n    \"country\": {\n      \"title\": \"Country / Booksy market\",\n      \"type\": \"string\",\n      \"description\": \"Which Booksy marketplace to use. Set the location to a city in the same country.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"us\",\n        \"gb\",\n        \"ie\",\n        \"au\",\n        \"ca\",\n        \"za\",\n        \"pl\",\n        \"es\",\n        \"mx\",\n        \"ar\",\n        \"cl\",\n        \"co\",\n        \"fr\",\n        \"br\",\n        \"pt\",\n        \"nl\",\n        \"de\"\n      ],\n      \"enumTitles\": [\n        \"United States\",\n        \"United Kingdom\",\n        \"Ireland\",\n        \"Australia\",\n        \"Canada\",\n        \"South Africa\",\n        \"Poland\",\n        \"Spain\",\n        \"Mexico\",\n        \"Argentina\",\n        \"Chile\",\n        \"Colombia\",\n        \"France\",\n        \"Brazil\",\n        \"Portugal\",\n        \"Netherlands\",\n        \"Germany\"\n      ],\n      \"default\": \"us\",\n      \"prefill\": \"us\"\n    },\n    \"businessIds\": {\n      \"title\": \"Business IDs or profile URLs\",\n      \"type\": \"array\",\n      \"description\": \"Booksy business IDs or full profile URLs (modes byBusinessId and reviews). Examples: '688238' or 'https://booksy.com/en-us/688238_name'. URLs also select their own country.\",\n      \"editor\": \"stringList\",\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"startUrls\": {\n      \"title\": \"Booksy URLs\",\n      \"type\": \"array\",\n      \"description\": \"Booksy search-result pages and/or business profile pages (mode=byUrl). Search pages are paginated automatically; profile pages return full details.\",\n      \"editor\": \"requestListSources\",\n      \"default\": [],\n      \"prefill\": [],\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"url\": {\n            \"title\": \"Booksy URL\",\n            \"description\": \"A Booksy search-result page or business profile URL.\",\n            \"type\": \"string\"\n          }\n        }\n      }\n    },\n    \"latitude\": {\n      \"title\": \"Latitude\",\n      \"type\": \"number\",\n      \"description\": \"GPS latitude for location-based search (modes search, byCategory). Overrides the Location field when both latitude and longitude are set.\",\n      \"minimum\": -90,\n      \"maximum\": 90,\n      \"sectionCaption\": \"Location and radius\",\n      \"sectionDescription\": \"Optional override for the city name and how far around it to search.\"\n    },\n    \"longitude\": {\n      \"title\": \"Longitude\",\n      \"type\": \"number\",\n      \"description\": \"GPS longitude for location-based search (modes search, byCategory). Overrides the Location field when both latitude and longitude are set.\",\n      \"minimum\": -180,\n      \"maximum\": 180\n    },\n    \"radiusKm\": {\n      \"title\": \"Search radius (km)\",\n      \"type\": \"integer\",\n      \"description\": \"Radius in kilometres around the location (modes search, byCategory). This is a hint to Booksy's search; Booksy may widen it when nearby matches are thin. Use distanceKm on each record to filter strictly.\",\n      \"minimum\": 1,\n      \"maximum\": 100,\n      \"default\": 10,\n      \"prefill\": 10\n    },\n    \"category\": {\n      \"title\": \"Category (mode=byCategory)\",\n      \"type\": \"string\",\n      \"description\": \"Service category to browse (mode=byCategory). Categories that are not offered in the selected country return an honest 0-result message.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"hair\",\n        \"barber\",\n        \"nails\",\n        \"skin-care\",\n        \"brows-and-lashes\",\n        \"massage\",\n        \"makeup\",\n        \"wellness-and-spa\",\n        \"braids-and-locs\",\n        \"tattoos\",\n        \"medical-aesthetics\",\n        \"hair-removal\",\n        \"home-services\",\n        \"piercing\",\n        \"pet-services\",\n        \"dental\",\n        \"health-and-fitness\",\n        \"professional-services\",\n        \"other\"\n      ],\n      \"enumTitles\": [\n        \"Hair\",\n        \"Barber\",\n        \"Nails\",\n        \"Skin Care\",\n        \"Brows and Lashes\",\n        \"Massage\",\n        \"Makeup\",\n        \"Wellness and Spa\",\n        \"Braids and Locs\",\n        \"Tattoos\",\n        \"Medical Aesthetics\",\n        \"Hair Removal\",\n        \"Home Services\",\n        \"Piercing\",\n        \"Pet Services\",\n        \"Dental and Orthodontics\",\n        \"Health and Fitness\",\n        \"Professional Services\",\n        \"Other\"\n      ],\n      \"default\": \"hair\",\n      \"prefill\": \"hair\",\n      \"sectionCaption\": \"Category and sort\",\n      \"sectionDescription\": \"Category browsing, result ordering, and an optional availability date.\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort results by\",\n      \"type\": \"string\",\n      \"description\": \"Result ordering for search, category, and URL search runs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"score\",\n        \"distance\",\n        \"rating\",\n        \"price\",\n        \"name\"\n      ],\n      \"enumTitles\": [\n        \"Booksy score (default)\",\n        \"Distance\",\n        \"Rating\",\n        \"Price\",\n        \"Name\"\n      ],\n      \"default\": \"score\",\n      \"prefill\": \"score\"\n    },\n    \"availableOn\": {\n      \"title\": \"Available on date\",\n      \"type\": \"string\",\n      \"description\": \"Optional date in YYYY-MM-DD format. Keeps only businesses with availability on that date. Leave empty for no date filter.\",\n      \"editor\": \"textfield\"\n    },\n    \"openNow\": {\n      \"title\": \"Open now only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only businesses that are open at the moment of the run.\",\n      \"default\": false,\n      \"prefill\": false,\n      \"sectionCaption\": \"Marketplace filters\",\n      \"sectionDescription\": \"Server-side filters applied by Booksy's own search.\"\n    },\n    \"hasOnlineServices\": {\n      \"title\": \"Online services only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only businesses offering virtual/online services.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"hasTravelingServices\": {\n      \"title\": \"Traveling services only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only mobile/traveling service businesses.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"hasSpecialOffers\": {\n      \"title\": \"Special offers only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only businesses with an active special offer or discount.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"acceptsGiftCards\": {\n      \"title\": \"Accepts Booksy gift cards\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only businesses that accept Booksy gift cards.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"acceptsBooksyPay\": {\n      \"title\": \"Accepts Booksy Pay\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only businesses that accept Booksy Pay.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"number\",\n      \"description\": \"Only include businesses rated at or above this value (0-5). Applies to business modes; reviews mode exports reviews unfiltered.\",\n      \"minimum\": 0,\n      \"maximum\": 5,\n      \"sectionCaption\": \"Client-side filters\",\n      \"sectionDescription\": \"Filters applied to returned records. They do not reduce the number of pages fetched.\"\n    },\n    \"maxRating\": {\n      \"title\": \"Maximum rating\",\n      \"type\": \"number\",\n      \"description\": \"Only include businesses rated at or below this value (0-5). Applies to business modes.\",\n      \"minimum\": 0,\n      \"maximum\": 5\n    },\n    \"minReviewCount\": {\n      \"title\": \"Minimum review count\",\n      \"type\": \"integer\",\n      \"description\": \"Only include businesses with at least this many reviews. Applies to business modes.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"filterCategory\": {\n      \"title\": \"Only these categories\",\n      \"type\": \"string\",\n      \"description\": \"Keep only business records whose primary category matches this value. Applies to business modes.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"hair\",\n        \"barber\",\n        \"nails\",\n        \"skin-care\",\n        \"brows-and-lashes\",\n        \"massage\",\n        \"makeup\",\n        \"wellness-and-spa\",\n        \"braids-and-locs\",\n        \"tattoos\",\n        \"medical-aesthetics\",\n        \"hair-removal\",\n        \"home-services\",\n        \"piercing\",\n        \"pet-services\",\n        \"dental\",\n        \"health-and-fitness\",\n        \"professional-services\",\n        \"other\"\n      ],\n      \"enumTitles\": [\n        \"Any category\",\n        \"Hair\",\n        \"Barber\",\n        \"Nails\",\n        \"Skin Care\",\n        \"Brows and Lashes\",\n        \"Massage\",\n        \"Makeup\",\n        \"Wellness and Spa\",\n        \"Braids and Locs\",\n        \"Tattoos\",\n        \"Medical Aesthetics\",\n        \"Hair Removal\",\n        \"Home Services\",\n        \"Piercing\",\n        \"Pet Services\",\n        \"Dental and Orthodontics\",\n        \"Health and Fitness\",\n        \"Professional Services\",\n        \"Other\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"isRecommended\": {\n      \"title\": \"Recommended businesses only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only businesses marked as recommended by Booksy. Applies to business modes.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"includeDetails\": {\n      \"title\": \"Fetch full business details\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch the full profile for each result (services with prices and durations, staff, hours, amenities, contacts, booking policy, review sample). Adds one request per business (modes search, byCategory, byUrl). Profile lookups always fetch details.\",\n      \"default\": true,\n      \"prefill\": false,\n      \"sectionCaption\": \"Detail enrichment\",\n      \"sectionDescription\": \"Optional extra requests per business. The daily test keeps these off.\"\n    },\n    \"includeReviews\": {\n      \"title\": \"Fetch additional reviews\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch more written reviews per business and add them to topReviews (business modes). Adds review requests per business.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxReviewsPerBusiness\": {\n      \"title\": \"Max reviews per business\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum written reviews to keep per business when includeReviews is on, or in reviews mode.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 20,\n      \"prefill\": 10\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum business records to return (or review records in reviews mode). Booksy caps a single query at 10,000 results; narrow the category, location, radius, or filters to reach more.\",\n      \"minimum\": 1,\n      \"maximum\": 10000,\n      \"default\": 50,\n      \"prefill\": 3,\n      \"sectionCaption\": \"Output limits\",\n      \"sectionDescription\": \"The daily test keeps this small.\"\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Booksy Beauty & Wellness Business Profile Scraper\n\nBooksy lists hundreds of thousands of salons, barbershops, nail studios, spas, and independent beauty professionals, but the site gives you one page at a time and no export button. This actor turns that public marketplace into structured business and review records: full service menus with prices and durations, staff, opening hours, amenities, photos, ratings, written reviews, and contact links. It works by keyword, category, business ID, or a pasted Booksy URL, across 17 Booksy markets.\n\n## What this actor does\n\n- **Five modes:** search by keyword, browse a service category, look up business IDs or profile URLs, export written reviews, or paste Booksy search/profile URLs.\n- **Real pagination:** reads every result page Booksy exposes for a query, up to the marketplace's 10,000-result ceiling, with duplicate removal across promoted listings.\n- **Rich profiles:** service menus with prices, durations, variants, deposits, and discounts; staff with positions and bios; weekly hours; amenities; photo galleries; booking and cancellation policy.\n- **17 markets:** United States, United Kingdom, Ireland, Australia, Canada, South Africa, Poland, Spain, Mexico, Argentina, Chile, Colombia, France, Brazil, Portugal, Netherlands, and Germany, with the market's local currency.\n- **Filters that match how buyers search:** rating range, minimum review count, primary category, recommended badge, open now, online/traveling services, special offers, gift cards, Booksy Pay, availability date, and sort order.\n- **Clean records:** fields the source did not publish for a business are left out instead of being sent as null, empty text, or a sentinel.\n- **Honest run status:** distinguishes a genuine zero-result query from HTTP or transport failures after retries, including partial results.\n- **Local-language URLs:** `byUrl` recognizes translated category URLs such as `/pl-pl/s/fryzjer` and `/pt-br/s/spa-massagem`.\n\n## Output per business\n\n- `businessId` — Booksy's business identifier\n- `name`, `slug`, `profileUrl`, `country`, `currency` (market currency, even without service details)\n- `address`, `city`, `state`, `zipCode`, `latitude`, `longitude`, `distanceKm`\n- `rating` — exact average, 0–5\n- `reviewCount`, `starRating`\n- `category` — primary category slug; `categoryId` — Booksy's local category ID\n- `serviceCategories` — every category the business is listed under\n- `services[]` — category, name, description, serviceId, treatmentId, treatmentName, price, priceText, durationMinutes, variantCount, bookable, onlineService, travelingService, stafferIds, photoUrls, variants[]\n- `serviceCount`, `priceFrom`, `priceTo`, `topServices`\n- `staff` — staff names; `staffMembers[]` — staffId, name, position, description, photoUrl, reviewsRankScore, active, visible; `staffCount`\n- `description`, `website`, `facebookUrl`, `instagramUrl`, `ecommerceUrl`, `contactName`\n- `bookingEnabled`, `bookingMode`, `bookingConfirmation`, `bookingPolicy`, `bookingLeadTimeDays`, `bookingChangeWindowHours`\n- `depositPolicy`, `depositCancelTimeHours`, `serviceFee`\n- `openHours[]` — day_of_week, dayName, open_from, open_till; `openHoursNote`\n- `amenities` — human-readable labels; `amenityDetails[]` — key and label\n- `hasParking`, `hasWheelchairAccess`, `acceptsCreditCards`\n- `imageUrl`, `imageUrls[]`, `logoUrl`\n- `isRecommended`, `bestOfBooksyBadge`, `isMobileService`, `isPromoted`, `maxDiscountRate`, `hasLowAvailability`\n- `offersVirtualServices`, `offersOnlineVouchers`, `acceptsBooksyGiftCards`, `acceptsBooksyPay`, `pricingLevel` (when Booksy returns it)\n- `profileType`, `newOnMarketplace`, `isBListListing`, `isRentingVenue`, `umbrellaVenueName`, `salonNetwork`, `hasSafetyRules`, `donationsEnabled`, `waitlistDisabled`\n- `topReviews[]` — text, rating, reviewerName, date, appointmentDate, verified, replyText, serviceNames, staffNames, photoUrls\n- `sourceUrl`, `scrapedAt`, `recordType` (`\"business\"`)\n\n## Output per review (mode = `reviews`)\n\n- `reviewId`, `rating`, `title`, `text`\n- `authorName`, `authorId`, `authorAvatarUrl`\n- `createdAt`, `updatedAt`, `appointmentDate`, `verified`, `anonymized`\n- `replyText`, `replyUpdatedAt`\n- `serviceNames[]`, `serviceIds[]`, `staffNames[]`, `staffIds[]`, `photoUrls[]`\n- `businessId`, `businessName`, `businessProfileUrl`, `businessRating`, `businessReviewCount`\n- `country`, `sourceUrl`, `scrapedAt`, `recordType` (`\"review\"`)\n\nReview records are written without invented text: if a customer left only a star rating, `text` is omitted.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `byCategory`, `byBusinessId`, `reviews`, or `byUrl`. |\n| `searchQuery` | string | `hair salon` | Keyword for `search` mode. Required in search mode; an empty or missing value is rejected. Use the market's language outside English markets. |\n| `location` | string | `New York` | City or area for `search` / `byCategory`; local-language names work (e.g. `Warszawa`, `Kraków`). Leave empty to search the whole country. |\n| `country` | string | `us` | Booksy market code: `us`, `gb`, `ie`, `au`, `ca`, `za`, `pl`, `es`, `mx`, `ar`, `cl`, `co`, `fr`, `br`, `pt`, `nl`, `de`. |\n| `businessIds` | array | `[]` | Business IDs or profile URLs for `byBusinessId` / `reviews`. URLs select their own country. |\n| `startUrls` | array | `[]` | Booksy search and/or profile URLs for `byUrl` mode. Local-language category URLs are recognized as category searches. |\n| `latitude` | number | - | GPS latitude; overrides `location` when longitude is also set. |\n| `longitude` | number | - | GPS longitude; overrides `location` when latitude is also set. |\n| `radiusKm` | integer | `10` | Search radius hint in kilometres, 1–100. |\n| `category` | string | `hair` | Category for `byCategory`: `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`. |\n| `sortBy` | string | `score` | `score`, `distance`, `rating`, `price`, or `name`. |\n| `availableOn` | string | - | Optional availability date in `YYYY-MM-DD` format. |\n| `openNow` | boolean | `false` | Keep only businesses open at the time of the run. |\n| `hasOnlineServices` | boolean | `false` | Keep only businesses offering virtual/online services. |\n| `hasTravelingServices` | boolean | `false` | Keep only mobile/traveling service businesses. |\n| `hasSpecialOffers` | boolean | `false` | Keep only businesses with an active special offer. |\n| `acceptsGiftCards` | boolean | `false` | Keep only businesses accepting Booksy gift cards. |\n| `acceptsBooksyPay` | boolean | `false` | Keep only businesses accepting Booksy Pay. |\n| `minRating` | number | - | Minimum average rating, 0–5 (business modes). |\n| `maxRating` | number | - | Maximum average rating, 0–5 (business modes). |\n| `minReviewCount` | integer | - | Minimum number of reviews (business modes). |\n| `filterCategory` | string | `Any` | Keep only business records in one primary category, or `Any`. |\n| `isRecommended` | boolean | `false` | Keep only businesses with the Booksy Recommended badge (business modes). |\n| `includeDetails` | boolean | `true` | Fetch the full profile (services, staff, hours, amenities, contacts, booking policy) for each result. |\n| `includeReviews` | boolean | `false` | Fetch additional written reviews per business into `topReviews` (business modes). |\n| `maxReviewsPerBusiness` | integer | `20` | Maximum reviews per business for `includeReviews` or `reviews` mode, 1–1000. |\n| `maxItems` | integer | `50` | Maximum records to return, 1–10000. |\n\n### Example: hair salons in New York with full details\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQuery\": \"hair salon\",\n  \"location\": \"New York\",\n  \"country\": \"us\",\n  \"minRating\": 4.5,\n  \"minReviewCount\": 25,\n  \"sortBy\": \"rating\",\n  \"includeDetails\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: browse barbers in Chicago, several pages\n\n```json\n{\n  \"mode\": \"byCategory\",\n  \"category\": \"barber\",\n  \"location\": \"Chicago\",\n  \"country\": \"us\",\n  \"radiusKm\": 15,\n  \"maxItems\": 300\n}\n```\n\n### Example: full profiles and reviews for specific businesses\n\n```json\n{\n  \"mode\": \"reviews\",\n  \"businessIds\": [\"688238\", \"https://booksy.com/pl-pl/694_hullhair_fryzjer_3_warszawa\"],\n  \"maxReviewsPerBusiness\": 100,\n  \"maxItems\": 500\n}\n```\n\n### Example: paste Booksy URLs\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"startUrls\": [\n    { \"url\": \"https://booksy.com/en-us/s/hair-salon/18229_chicago\" },\n    { \"url\": \"https://booksy.com/en-gb/s/barber/1033813_bristol\" }\n  ],\n  \"maxItems\": 200\n}\n```\n\n### Example: local-language search in Spain\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQuery\": \"peluqueria\",\n  \"location\": \"Madrid\",\n  \"country\": \"es\",\n  \"maxItems\": 50\n}\n```\n\n## Use cases\n\n- **Beauty-supply and distributor sales** — build city-level lead lists of salons, barbers, and spas with contact links, service mix, and size signals.\n- **Price benchmarking** — compare haircut, manicure, massage, and spa menus across competitors, including durations, deposits, and discounts.\n- **Franchise and site selection** — measure category density and ratings by neighbourhood before opening or expanding.\n- **Reputation monitoring** — export new reviews with rating, service, staff, and owner replies on a schedule.\n- **Directory and marketplace builders** — seed a local beauty directory with structured profiles, photos, and hours.\n- **Market research across countries** — compare service menus and price points between Booksy markets in local currency.\n\n## FAQ\n\n### Do I need a Booksy account or an API key?\n\nNo. The actor reads the public Booksy marketplace that any visitor can see. There is no login, cookie, token, or proxy setup.\n\n### What is the difference between search and byCategory?\n\n`search` matches a keyword near a location (for example \"balayage\" in London). `byCategory` browses Booksy's own category taxonomy (hair, barber, nails, massage, and so on) and is usually the better way to enumerate every business in a category and city.\n\n### Why are some fields or whole records missing?\n\nBooksy lets each business publish only what it wants. A business without a website, staff list, services, or written reviews simply has no value for those fields, so the field is omitted. The record itself is still returned.\n\n### Are phone numbers and emails included?\n\nNo. Booksy does not publish business phone numbers or emails on the public profile; the contact channels are the website, Instagram/Facebook links, address, and Booksy profile URL.\n\n### How many businesses can I get from one query?\n\nBooksy caps a single search at 10,000 results. The actor reads every page up to that ceiling and removes promoted duplicates. To go beyond 10,000, split the run by category, location, or a smaller radius.\n\n### Why did I get fewer results than `maxItems`?\n\nThe source ran out of unique businesses for that query, or the selected category is not offered in that country. The run status message reports the source count and the reason. Try a broader keyword, a larger radius, a different city, or another category.\n\n### What happens if Booksy returns an error?\n\nThe actor retries transient HTTP and network failures with backoff. If a request still fails, the final status message reports the failed request count instead of pretending the source returned zero results. A partial run also says that results may be incomplete.\n\n### Does `maxReviewsPerBusiness` return the full requested count?\n\nYes, when the business has enough reviews. Review pagination uses a fixed page size and reads the next offset, including values such as 101, 130, 199, and 250.\n\n### Does search work in local languages?\n\nYes, and it usually must. Booksy search is language-sensitive: \"hair\" works in the US and UK, but \"fryzjer\" works in Poland, \"peluqueria\" in Spain, and \"cabelo\" in Brazil. Category browsing avoids the keyword entirely where the category exists.\n\n### Are reviews always included?\n\n`byBusinessId` profiles include a small sample of recent reviews. Use `includeReviews` for more per business, or `reviews` mode to export review records with text, rating, author, date, service, staff, and owner reply.\n\n### Do I need to configure a proxy?\n\nNo. The actor chooses a working connection to Booksy automatically. Just fill in the input and run it.\n\n### Is this affiliated with Booksy?\n\nNo. This is a third-party actor that reads public Booksy marketplace pages and is not affiliated with, endorsed by, or connected to Booksy.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "booksy-beauty-and-wellness-business-profile",
      "title": "Booksy Beauty & Wellness Business Profile Scraper",
      "description": "Scrape Booksy beauty and wellness businesses across 17 markets — full service menus, staff, hours, amenities, photos, ratings, reviews, and contacts by keyword, category, business ID, or Booksy URL.",
      "version": "2.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Booksy Beauty & Wellness Business Profile Scraper\n\nBooksy lists hundreds of thousands of salons, barbershops, nail studios, spas, and independent beauty professionals, but the site gives you one page at a time and no export button. This actor turns that public marketplace into structured business and review records: full service menus with prices and durations, staff, opening hours, amenities, photos, ratings, written reviews, and contact links. It works by keyword, category, business ID, or a pasted Booksy URL, across 17 Booksy markets.\n\n## What this actor does\n\n- **Five modes:** search by keyword, browse a service category, look up business IDs or profile URLs, export written reviews, or paste Booksy search/profile URLs.\n- **Real pagination:** reads every result page Booksy exposes for a query, up to the marketplace's 10,000-result ceiling, with duplicate removal across promoted listings.\n- **Rich profiles:** service menus with prices, durations, variants, deposits, and discounts; staff with positions and bios; weekly hours; amenities; photo galleries; booking and cancellation policy.\n- **17 markets:** United States, United Kingdom, Ireland, Australia, Canada, South Africa, Poland, Spain, Mexico, Argentina, Chile, Colombia, France, Brazil, Portugal, Netherlands, and Germany, with the market's local currency.\n- **Filters that match how buyers search:** rating range, minimum review count, primary category, recommended badge, open now, online/traveling services, special offers, gift cards, Booksy Pay, availability date, and sort order.\n- **Clean records:** fields the source did not publish for a business are left out instead of being sent as null, empty text, or a sentinel.\n- **Honest run status:** distinguishes a genuine zero-result query from HTTP or transport failures after retries, including partial results.\n- **Local-language URLs:** `byUrl` recognizes translated category URLs such as `/pl-pl/s/fryzjer` and `/pt-br/s/spa-massagem`.\n\n## Output per business\n\n- `businessId` — Booksy's business identifier\n- `name`, `slug`, `profileUrl`, `country`, `currency` (market currency, even without service details)\n- `address`, `city`, `state`, `zipCode`, `latitude`, `longitude`, `distanceKm`\n- `rating` — exact average, 0–5\n- `reviewCount`, `starRating`\n- `category` — primary category slug; `categoryId` — Booksy's local category ID\n- `serviceCategories` — every category the business is listed under\n- `services[]` — category, name, description, serviceId, treatmentId, treatmentName, price, priceText, durationMinutes, variantCount, bookable, onlineService, travelingService, stafferIds, photoUrls, variants[]\n- `serviceCount`, `priceFrom`, `priceTo`, `topServices`\n- `staff` — staff names; `staffMembers[]` — staffId, name, position, description, photoUrl, reviewsRankScore, active, visible; `staffCount`\n- `description`, `website`, `facebookUrl`, `instagramUrl`, `ecommerceUrl`, `contactName`\n- `bookingEnabled`, `bookingMode`, `bookingConfirmation`, `bookingPolicy`, `bookingLeadTimeDays`, `bookingChangeWindowHours`\n- `depositPolicy`, `depositCancelTimeHours`, `serviceFee`\n- `openHours[]` — day_of_week, dayName, open_from, open_till; `openHoursNote`\n- `amenities` — human-readable labels; `amenityDetails[]` — key and label\n- `hasParking`, `hasWheelchairAccess`, `acceptsCreditCards`\n- `imageUrl`, `imageUrls[]`, `logoUrl`\n- `isRecommended`, `bestOfBooksyBadge`, `isMobileService`, `isPromoted`, `maxDiscountRate`, `hasLowAvailability`\n- `offersVirtualServices`, `offersOnlineVouchers`, `acceptsBooksyGiftCards`, `acceptsBooksyPay`, `pricingLevel` (when Booksy returns it)\n- `profileType`, `newOnMarketplace`, `isBListListing`, `isRentingVenue`, `umbrellaVenueName`, `salonNetwork`, `hasSafetyRules`, `donationsEnabled`, `waitlistDisabled`\n- `topReviews[]` — text, rating, reviewerName, date, appointmentDate, verified, replyText, serviceNames, staffNames, photoUrls\n- `sourceUrl`, `scrapedAt`, `recordType` (`\"business\"`)\n\n## Output per review (mode = `reviews`)\n\n- `reviewId`, `rating`, `title`, `text`\n- `authorName`, `authorId`, `authorAvatarUrl`\n- `createdAt`, `updatedAt`, `appointmentDate`, `verified`, `anonymized`\n- `replyText`, `replyUpdatedAt`\n- `serviceNames[]`, `serviceIds[]`, `staffNames[]`, `staffIds[]`, `photoUrls[]`\n- `businessId`, `businessName`, `businessProfileUrl`, `businessRating`, `businessReviewCount`\n- `country`, `sourceUrl`, `scrapedAt`, `recordType` (`\"review\"`)\n\nReview records are written without invented text: if a customer left only a star rating, `text` is omitted.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `byCategory`, `byBusinessId`, `reviews`, or `byUrl`. |\n| `searchQuery` | string | `hair salon` | Keyword for `search` mode. Required in search mode; an empty or missing value is rejected. Use the market's language outside English markets. |\n| `location` | string | `New York` | City or area for `search` / `byCategory`; local-language names work (e.g. `Warszawa`, `Kraków`). Leave empty to search the whole country. |\n| `country` | string | `us` | Booksy market code: `us`, `gb`, `ie`, `au`, `ca`, `za`, `pl`, `es`, `mx`, `ar`, `cl`, `co`, `fr`, `br`, `pt`, `nl`, `de`. |\n| `businessIds` | array | `[]` | Business IDs or profile URLs for `byBusinessId` / `reviews`. URLs select their own country. |\n| `startUrls` | array | `[]` | Booksy search and/or profile URLs for `byUrl` mode. Local-language category URLs are recognized as category searches. |\n| `latitude` | number | - | GPS latitude; overrides `location` when longitude is also set. |\n| `longitude` | number | - | GPS longitude; overrides `location` when latitude is also set. |\n| `radiusKm` | integer | `10` | Search radius hint in kilometres, 1–100. |\n| `category` | string | `hair` | Category for `byCategory`: `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`. |\n| `sortBy` | string | `score` | `score`, `distance`, `rating`, `price`, or `name`. |\n| `availableOn` | string | - | Optional availability date in `YYYY-MM-DD` format. |\n| `openNow` | boolean | `false` | Keep only businesses open at the time of the run. |\n| `hasOnlineServices` | boolean | `false` | Keep only businesses offering virtual/online services. |\n| `hasTravelingServices` | boolean | `false` | Keep only mobile/traveling service businesses. |\n| `hasSpecialOffers` | boolean | `false` | Keep only businesses with an active special offer. |\n| `acceptsGiftCards` | boolean | `false` | Keep only businesses accepting Booksy gift cards. |\n| `acceptsBooksyPay` | boolean | `false` | Keep only businesses accepting Booksy Pay. |\n| `minRating` | number | - | Minimum average rating, 0–5 (business modes). |\n| `maxRating` | number | - | Maximum average rating, 0–5 (business modes). |\n| `minReviewCount` | integer | - | Minimum number of reviews (business modes). |\n| `filterCategory` | string | `Any` | Keep only business records in one primary category, or `Any`. |\n| `isRecommended` | boolean | `false` | Keep only businesses with the Booksy Recommended badge (business modes). |\n| `includeDetails` | boolean | `true` | Fetch the full profile (services, staff, hours, amenities, contacts, booking policy) for each result. |\n| `includeReviews` | boolean | `false` | Fetch additional written reviews per business into `topReviews` (business modes). |\n| `maxReviewsPerBusiness` | integer | `20` | Maximum reviews per business for `includeReviews` or `reviews` mode, 1–1000. |\n| `maxItems` | integer | `50` | Maximum records to return, 1–10000. |\n\n### Example: hair salons in New York with full details\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQuery\": \"hair salon\",\n  \"location\": \"New York\",\n  \"country\": \"us\",\n  \"minRating\": 4.5,\n  \"minReviewCount\": 25,\n  \"sortBy\": \"rating\",\n  \"includeDetails\": true,\n  \"maxItems\": 100\n}\n```\n\n### Example: browse barbers in Chicago, several pages\n\n```json\n{\n  \"mode\": \"byCategory\",\n  \"category\": \"barber\",\n  \"location\": \"Chicago\",\n  \"country\": \"us\",\n  \"radiusKm\": 15,\n  \"maxItems\": 300\n}\n```\n\n### Example: full profiles and reviews for specific businesses\n\n```json\n{\n  \"mode\": \"reviews\",\n  \"businessIds\": [\"688238\", \"https://booksy.com/pl-pl/694_hullhair_fryzjer_3_warszawa\"],\n  \"maxReviewsPerBusiness\": 100,\n  \"maxItems\": 500\n}\n```\n\n### Example: paste Booksy URLs\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"startUrls\": [\n    { \"url\": \"https://booksy.com/en-us/s/hair-salon/18229_chicago\" },\n    { \"url\": \"https://booksy.com/en-gb/s/barber/1033813_bristol\" }\n  ],\n  \"maxItems\": 200\n}\n```\n\n### Example: local-language search in Spain\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQuery\": \"peluqueria\",\n  \"location\": \"Madrid\",\n  \"country\": \"es\",\n  \"maxItems\": 50\n}\n```\n\n## Use cases\n\n- **Beauty-supply and distributor sales** — build city-level lead lists of salons, barbers, and spas with contact links, service mix, and size signals.\n- **Price benchmarking** — compare haircut, manicure, massage, and spa menus across competitors, including durations, deposits, and discounts.\n- **Franchise and site selection** — measure category density and ratings by neighbourhood before opening or expanding.\n- **Reputation monitoring** — export new reviews with rating, service, staff, and owner replies on a schedule.\n- **Directory and marketplace builders** — seed a local beauty directory with structured profiles, photos, and hours.\n- **Market research across countries** — compare service menus and price points between Booksy markets in local currency.\n\n## FAQ\n\n### Do I need a Booksy account or an API key?\n\nNo. The actor reads the public Booksy marketplace that any visitor can see. There is no login, cookie, token, or proxy setup.\n\n### What is the difference between search and byCategory?\n\n`search` matches a keyword near a location (for example \"balayage\" in London). `byCategory` browses Booksy's own category taxonomy (hair, barber, nails, massage, and so on) and is usually the better way to enumerate every business in a category and city.\n\n### Why are some fields or whole records missing?\n\nBooksy lets each business publish only what it wants. A business without a website, staff list, services, or written reviews simply has no value for those fields, so the field is omitted. The record itself is still returned.\n\n### Are phone numbers and emails included?\n\nNo. Booksy does not publish business phone numbers or emails on the public profile; the contact channels are the website, Instagram/Facebook links, address, and Booksy profile URL.\n\n### How many businesses can I get from one query?\n\nBooksy caps a single search at 10,000 results. The actor reads every page up to that ceiling and removes promoted duplicates. To go beyond 10,000, split the run by category, location, or a smaller radius.\n\n### Why did I get fewer results than `maxItems`?\n\nThe source ran out of unique businesses for that query, or the selected category is not offered in that country. The run status message reports the source count and the reason. Try a broader keyword, a larger radius, a different city, or another category.\n\n### What happens if Booksy returns an error?\n\nThe actor retries transient HTTP and network failures with backoff. If a request still fails, the final status message reports the failed request count instead of pretending the source returned zero results. A partial run also says that results may be incomplete.\n\n### Does `maxReviewsPerBusiness` return the full requested count?\n\nYes, when the business has enough reviews. Review pagination uses a fixed page size and reads the next offset, including values such as 101, 130, 199, and 250.\n\n### Does search work in local languages?\n\nYes, and it usually must. Booksy search is language-sensitive: \"hair\" works in the US and UK, but \"fryzjer\" works in Poland, \"peluqueria\" in Spain, and \"cabelo\" in Brazil. Category browsing avoids the keyword entirely where the category exists.\n\n### Are reviews always included?\n\n`byBusinessId` profiles include a small sample of recent reviews. Use `includeReviews` for more per business, or `reviews` mode to export review records with text, rating, author, date, service, staff, and owner reply.\n\n### Do I need to configure a proxy?\n\nNo. The actor chooses a working connection to Booksy automatically. Just fill in the input and run it.\n\n### Is this affiliated with Booksy?\n\nNo. This is a third-party actor that reads public Booksy marketplace pages and is not affiliated with, endorsed by, or connected to Booksy.\n",
      "input": {
        "title": "Booksy Beauty & Wellness Business Profile Scraper Input",
        "description": "Search Booksy businesses by keyword, browse a category, look up business IDs or profile URLs, or export reviews across 17 Booksy markets.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to scrape.",
            "editor": "select",
            "enum": [
              "search",
              "byCategory",
              "byBusinessId",
              "reviews",
              "byUrl"
            ],
            "enumTitles": [
              "Search — keyword and location",
              "By Category — browse one service category",
              "By Business ID — full profiles for IDs or profile URLs",
              "Reviews — export written reviews for IDs or profile URLs",
              "By URL — paste Booksy search and/or profile links"
            ],
            "default": "search",
            "prefill": "search"
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Keyword to search for (mode=search). Required for search mode; an empty or missing value is rejected instead of falling back to a default. Examples: 'hair salon', 'barber', 'nail salon', 'massage', 'eyebrows'. Use the market's language for non-English countries (e.g. 'fryzjer' in Poland, 'peluqueria' in Spain).",
            "editor": "textfield",
            "default": "hair salon",
            "prefill": "hair salon"
          },
          "location": {
            "title": "Location (city or area)",
            "type": "string",
            "description": "City or area to search near (modes search, byCategory). Local-language city names work (e.g. 'Warszawa', 'Kraków'). Leave empty to search the whole country. Latitude/longitude override this field.",
            "editor": "textfield",
            "default": "New York",
            "prefill": "New York"
          },
          "country": {
            "title": "Country / Booksy market",
            "type": "string",
            "description": "Which Booksy marketplace to use. Set the location to a city in the same country.",
            "editor": "select",
            "enum": [
              "us",
              "gb",
              "ie",
              "au",
              "ca",
              "za",
              "pl",
              "es",
              "mx",
              "ar",
              "cl",
              "co",
              "fr",
              "br",
              "pt",
              "nl",
              "de"
            ],
            "enumTitles": [
              "United States",
              "United Kingdom",
              "Ireland",
              "Australia",
              "Canada",
              "South Africa",
              "Poland",
              "Spain",
              "Mexico",
              "Argentina",
              "Chile",
              "Colombia",
              "France",
              "Brazil",
              "Portugal",
              "Netherlands",
              "Germany"
            ],
            "default": "us",
            "prefill": "us"
          },
          "businessIds": {
            "title": "Business IDs or profile URLs",
            "type": "array",
            "description": "Booksy business IDs or full profile URLs (modes byBusinessId and reviews). Examples: '688238' or 'https://booksy.com/en-us/688238_name'. URLs also select their own country.",
            "editor": "stringList",
            "default": [],
            "prefill": []
          },
          "startUrls": {
            "title": "Booksy URLs",
            "type": "array",
            "description": "Booksy search-result pages and/or business profile pages (mode=byUrl). Search pages are paginated automatically; profile pages return full details.",
            "editor": "requestListSources",
            "default": [],
            "prefill": [],
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "Booksy URL",
                  "description": "A Booksy search-result page or business profile URL.",
                  "type": "string"
                }
              }
            }
          },
          "latitude": {
            "title": "Latitude",
            "type": "number",
            "description": "GPS latitude for location-based search (modes search, byCategory). Overrides the Location field when both latitude and longitude are set.",
            "minimum": -90,
            "maximum": 90,
            "sectionCaption": "Location and radius",
            "sectionDescription": "Optional override for the city name and how far around it to search."
          },
          "longitude": {
            "title": "Longitude",
            "type": "number",
            "description": "GPS longitude for location-based search (modes search, byCategory). Overrides the Location field when both latitude and longitude are set.",
            "minimum": -180,
            "maximum": 180
          },
          "radiusKm": {
            "title": "Search radius (km)",
            "type": "integer",
            "description": "Radius in kilometres around the location (modes search, byCategory). This is a hint to Booksy's search; Booksy may widen it when nearby matches are thin. Use distanceKm on each record to filter strictly.",
            "minimum": 1,
            "maximum": 100,
            "default": 10,
            "prefill": 10
          },
          "category": {
            "title": "Category (mode=byCategory)",
            "type": "string",
            "description": "Service category to browse (mode=byCategory). Categories that are not offered in the selected country return an honest 0-result message.",
            "editor": "select",
            "enum": [
              "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"
            ],
            "enumTitles": [
              "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 and Orthodontics",
              "Health and Fitness",
              "Professional Services",
              "Other"
            ],
            "default": "hair",
            "prefill": "hair",
            "sectionCaption": "Category and sort",
            "sectionDescription": "Category browsing, result ordering, and an optional availability date."
          },
          "sortBy": {
            "title": "Sort results by",
            "type": "string",
            "description": "Result ordering for search, category, and URL search runs.",
            "editor": "select",
            "enum": [
              "score",
              "distance",
              "rating",
              "price",
              "name"
            ],
            "enumTitles": [
              "Booksy score (default)",
              "Distance",
              "Rating",
              "Price",
              "Name"
            ],
            "default": "score",
            "prefill": "score"
          },
          "availableOn": {
            "title": "Available on date",
            "type": "string",
            "description": "Optional date in YYYY-MM-DD format. Keeps only businesses with availability on that date. Leave empty for no date filter.",
            "editor": "textfield"
          },
          "openNow": {
            "title": "Open now only",
            "type": "boolean",
            "description": "Keep only businesses that are open at the moment of the run.",
            "default": false,
            "prefill": false,
            "sectionCaption": "Marketplace filters",
            "sectionDescription": "Server-side filters applied by Booksy's own search."
          },
          "hasOnlineServices": {
            "title": "Online services only",
            "type": "boolean",
            "description": "Keep only businesses offering virtual/online services.",
            "default": false,
            "prefill": false
          },
          "hasTravelingServices": {
            "title": "Traveling services only",
            "type": "boolean",
            "description": "Keep only mobile/traveling service businesses.",
            "default": false,
            "prefill": false
          },
          "hasSpecialOffers": {
            "title": "Special offers only",
            "type": "boolean",
            "description": "Keep only businesses with an active special offer or discount.",
            "default": false,
            "prefill": false
          },
          "acceptsGiftCards": {
            "title": "Accepts Booksy gift cards",
            "type": "boolean",
            "description": "Keep only businesses that accept Booksy gift cards.",
            "default": false,
            "prefill": false
          },
          "acceptsBooksyPay": {
            "title": "Accepts Booksy Pay",
            "type": "boolean",
            "description": "Keep only businesses that accept Booksy Pay.",
            "default": false,
            "prefill": false
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "number",
            "description": "Only include businesses rated at or above this value (0-5). Applies to business modes; reviews mode exports reviews unfiltered.",
            "minimum": 0,
            "maximum": 5,
            "sectionCaption": "Client-side filters",
            "sectionDescription": "Filters applied to returned records. They do not reduce the number of pages fetched."
          },
          "maxRating": {
            "title": "Maximum rating",
            "type": "number",
            "description": "Only include businesses rated at or below this value (0-5). Applies to business modes.",
            "minimum": 0,
            "maximum": 5
          },
          "minReviewCount": {
            "title": "Minimum review count",
            "type": "integer",
            "description": "Only include businesses with at least this many reviews. Applies to business modes.",
            "minimum": 0,
            "maximum": 1000000
          },
          "filterCategory": {
            "title": "Only these categories",
            "type": "string",
            "description": "Keep only business records whose primary category matches this value. Applies to business modes.",
            "editor": "select",
            "enum": [
              "",
              "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"
            ],
            "enumTitles": [
              "Any category",
              "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 and Orthodontics",
              "Health and Fitness",
              "Professional Services",
              "Other"
            ],
            "default": "",
            "prefill": ""
          },
          "isRecommended": {
            "title": "Recommended businesses only",
            "type": "boolean",
            "description": "Keep only businesses marked as recommended by Booksy. Applies to business modes.",
            "default": false,
            "prefill": false
          },
          "includeDetails": {
            "title": "Fetch full business details",
            "type": "boolean",
            "description": "Fetch the full profile for each result (services with prices and durations, staff, hours, amenities, contacts, booking policy, review sample). Adds one request per business (modes search, byCategory, byUrl). Profile lookups always fetch details.",
            "default": true,
            "prefill": false,
            "sectionCaption": "Detail enrichment",
            "sectionDescription": "Optional extra requests per business. The daily test keeps these off."
          },
          "includeReviews": {
            "title": "Fetch additional reviews",
            "type": "boolean",
            "description": "Fetch more written reviews per business and add them to topReviews (business modes). Adds review requests per business.",
            "default": false,
            "prefill": false
          },
          "maxReviewsPerBusiness": {
            "title": "Max reviews per business",
            "type": "integer",
            "description": "Maximum written reviews to keep per business when includeReviews is on, or in reviews mode.",
            "minimum": 1,
            "maximum": 1000,
            "default": 20,
            "prefill": 10
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Maximum business records to return (or review records in reviews mode). Booksy caps a single query at 10,000 results; narrow the category, location, radius, or filters to reach more.",
            "minimum": 1,
            "maximum": 10000,
            "default": 50,
            "prefill": 3,
            "sectionCaption": "Output limits",
            "sectionDescription": "The daily test keeps this small."
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Booksy Beauty & Wellness Business Profile Scraper Output",
        "description": "Booksy business profiles and written reviews from 17 markets — services with prices and durations, staff, hours, amenities, contacts, ratings, and booking details.",
        "properties": {
          "businesses": {
            "type": "string",
            "title": "Booksy businesses",
            "description": "Dataset of Booksy businesses with ratings, services, staff, hours, amenities, contacts, and booking details.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          },
          "reviews": {
            "type": "string",
            "title": "Booksy reviews",
            "description": "Dataset view for review records produced by reviews mode (review text, rating, author, date, service, staff, and owner reply).",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "defaultMemoryMbytes": 1024,
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Businesses",
              "transformation": {
                "fields": [
                  "name",
                  "category",
                  "city",
                  "rating",
                  "reviewCount",
                  "address",
                  "profileUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "2.0.1",
    "imageDigest": "a1e6b89ffda0fa40ce4b69830857dd58152ea71658c70f8a3c1b314d11c203b1",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "2.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.012374444444444445
    }
  }
}