{ "openapi": "3.0.1", "info": { "title": "Fresha Leads Scraper", "description": "[💰 $10 / 1K] Extract salon, barber, spa, nail, and beauty business leads from Fresha — names, contact details, ratings, services, pricing, and location. Search by keyword and location or paste Fresha URLs.", "version": "1.0", "x-build-id": "qkdBOo9Wh6Cpc42ky" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~fresha-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-fresha-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/solidcode~fresha-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-fresha-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/solidcode~fresha-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-fresha-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": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "What kind of business to find on Fresha (e.g. 'barber', 'nail salon', 'massage', 'spa'). Each term is combined with the Location below. Leave empty if you paste full Fresha URLs instead.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City or area to search in (e.g. 'London, UK', 'New York, NY', 'Sydney'). Combined with each Search Term. Leave empty if you paste full Fresha URLs." }, "category": { "title": "Category", "enum": [ "", "category:hair-and-styling", "category:nails", "category:hair-removal", "category:eyebrows-and-eyelashes", "category:facials-and-skincare", "category:massage", "category:makeup", "category:aesthetics", "category:barbering", "category:spa-and-wellness", "category:body-and-skin", "category:tattoo-and-piercing", "category:holistic-health", "category:dental", "category:medical", "category:pet-services", "category:health-and-fitness", "category:physical-therapy", "category:counselling-and-therapy", "category:other" ], "type": "string", "description": "Optionally narrow results to one Fresha category. Leave as 'Any category' to search across all beauty & wellness types.", "default": "" }, "startUrls": { "title": "Fresha URLs", "type": "array", "description": "Paste Fresha venue or search URLs directly, e.g. https://www.fresha.com/a/venue-name. When provided, these are scraped in addition to any Search Terms above. A pasted venue link always returns that venue's full profile (phone, address, pricing) — even when Include Contact Details is off — because you asked for that specific business.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of business leads to return across all searches and URLs. Set to 0 for unlimited (up to a 100,000-result safety ceiling per run). Each Search Term + Location pair sweeps a grid of nearby points to go deep on dense cities; that grid tops out at roughly 16,000 venues per single city before de-duplication, so to pull more than that for one city, split it into several nearby locations. Tip: start with 20-50 to test, then increase.", "default": 100 }, "includeContactDetails": { "title": "Include Contact Details (phone, full address & description)", "type": "boolean", "description": "Fetch each business's phone number, full street address, description, and starting price by opening its profile page. This is the core value of a leads list, so it is on by default. It makes one extra lookup per business, so a run takes a little longer. Turn it off for a faster, lighter run when you only need names, ratings, categories, and approximate locations. (This toggle applies to keyword + location searches; a venue link pasted into Fresha URLs always returns full contact details.)", "default": true }, "country": { "title": "Country / Region", "enum": [ "gb", "us", "au", "ca", "ie", "nz", "ae", "es", "it", "nl", "de", "fr", "pt" ], "type": "string", "description": "Which Fresha region to search. Affects the businesses returned for keyword + location searches.", "default": "gb" } } }, "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 } } } } } } } } } }