{ "openapi": "3.0.1", "info": { "title": "Booksy Scraper — Salon, Barber & Beauty Business Data", "description": "Scrape Booksy local business listings by service and city. Extract salon, barber, spa, nail and beauty business name, full address, GPS coordinates, rating, review count, category, photos and booking badges. Export to JSON/CSV/Excel for local lead generation and market research.", "version": "0.1", "x-build-id": "w30jdt1RZTR4ytRmB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~booksy-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-booksy-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/haketa~booksy-scraper/runs": { "post": { "operationId": "runs-sync-haketa-booksy-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/haketa~booksy-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-booksy-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "service": { "title": "Service / category", "enum": [ "", "hair-salon", "barber", "nail-salon", "eyelashes-eyebrows", "massage", "spa", "waxing", "makeup", "skin-care", "hair-removal", "braids", "tattoo-piercing", "wellness" ], "type": "string", "description": "Pick the type of business to collect. Choose \"All services\" to pull every kind of local beauty & wellness business in the selected location.", "default": "" }, "location": { "title": "Location (US state)", "enum": [ "", "10009_florida", "10043_texas", "100003_california", "10014_illinois", "9_new-york", "10026_north-carolina", "10010_georgia", "10030_new-jersey", "10037_pennsylvania", "10019_massachusetts", "10034_ohio", "10045_virginia", "10004_arizona", "10005_colorado", "10020_maryland", "10015_indiana", "10032_nevada", "10042_tennessee", "10047_washington", "10021_michigan", "10022_minnesota", "10040_south-carolina", "10018_louisiana", "10006_connecticut", "10031_new-mexico", "10002_alabama", "10048_wisconsin", "10024_mississippi", "10023_missouri", "10035_oklahoma", "10017_kentucky", "10012_iowa", "10044_utah", "10036_oregon", "10003_arkansas", "10016_kansas", "10039_rhode-island", "10008_delaware", "10028_nebraska", "10029_new-hampshire", "10011_hawaii", "10013_idaho", "10007_district-of-columbia", "10049_west-virginia", "10001_alaska", "10027_north-dakota", "10050_wyoming", "10025_montana", "103896_maine", "10041_south-dakota", "10046_vermont" ], "type": "string", "description": "Pick a US state to collect businesses from. Choose \"All states (nationwide sample)\" for a fast, mixed sample across popular states. Covers all 50 states plus DC. For a specific city, use the Advanced start URLs field below.", "default": "" }, "maxItems": { "title": "Max businesses", "minimum": 0, "type": "integer", "description": "Maximum number of businesses to collect. Set 0 for no limit (Booksy caps a search at ~10,000). Default 100 for a fast, low-cost run.", "default": 100 }, "startUrls": { "title": "Advanced: Booksy search URLs", "type": "array", "description": "Optional. Power users can paste specific Booksy search-result URLs (e.g. a single city) to scrape instead of the dropdowns above. Search on booksy.com, then copy the browser URL here — for example https://booksy.com/en-us/s/hair-salon/18229_chicago. When set, these URLs take priority over the Service and Location dropdowns.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Booksy serves US business data — a US proxy is recommended. Apify Proxy (US) is on by default.", "default": { "useApifyProxy": true, "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }