The hosted Actor accepts one JSON object.
| Field | Type | Required | Example | Description |
|---|---|---|---|---|
countryCodes |
array of strings | No | ["us", "es"] |
Country or regional profiles. Omitting it uses all 16 supported countries; add ny explicitly for the optional New York regional profile. |
mode |
string | No | "listings" |
listings returns search records. details discovers records and requests each business profile. |
categories |
array of strings | No | ["hair-salon"] |
Profile-specific category slugs. An empty list discovers the active category catalog at run time. |
maxBusinessesPerCategory |
integer | No | 100 |
Safety limit applied after deduplication for each category and profile. Valid range: 1–100,000. |
requestDelayMs |
integer | No | 100 |
Minimum spacing between Booksy requests. Valid range: 100–2,000 milliseconds. |
regionSplitThreshold |
integer | No | 9000 |
Result-count threshold at which a high-volume region is subdivided. Valid range: 1,000–10,000. |
maxPagesPerRegion |
integer | No | 100 |
Pagination ceiling for a single region. Valid range: 1–10,000. |
datasetBatchSize |
integer | No | 25 |
Number of output items buffered before a Dataset write. Valid range: 1–100. |
includeErrors |
boolean | No | true |
When enabled, failed pages or detail requests are emitted as status: "error" items. |
resume |
boolean | No | true |
Reuses compact Actor checkpoints after a restart to skip completed units. |
The API defaults are all 16 country profiles, listings mode, all active categories, 100 ms request spacing, a 9,000 regional split threshold, 1,000 pages per region, a Dataset batch size of 25, error items enabled and resume enabled. The Apify input form uses a deliberately smaller prefilled test so a new user does not start a large run accidentally.
Concurrency and retry controls are intentionally not public inputs. The Actor uses its validated internal transport policy so that an unsafe user-provided worker count or retry budget cannot destabilize a run.
The supported country codes are ar, au, br, ca, cl, co, fr, ie, mx, nl, pl, pt, za, es, gb and us. ny is an additional regional profile on the US domain. Category names can differ between profiles, so do not assume a slug is valid in every country.