{
  "data": {
    "id": "fI87q4jQj6qFsi2hf",
    "actId": "LZRFYdMyUgUdQ5gmp",
    "userId": "IYgBDiXtHOijAaUel",
    "startedAt": "2026-11-14T15:26:26.719Z",
    "finishedAt": "2026-11-14T15:26:36.493Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 9726,
      "runTimeSecs": 9.726,
      "computeUnits": 0.010806666666666666,
      "imageSizeBytes": 340225536
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "QYo53EZkJk0prePWY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"local.ch Scraper Input\",\n  \"description\": \"Search local.ch (Switzerland's leading business directory) by category and city/canton, or fetch full business profiles by direct URL.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to fetch: search a category + city/canton, or fetch full business profiles from direct local.ch URLs.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"detail\"\n      ],\n      \"enumTitles\": [\n        \"Search by category & city/canton\",\n        \"Fetch business profiles by URL\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"category\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"description\": \"Business category to search for. Pick a common category, or choose 'Custom category' and type your own below (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"custom\",\n        \"restaurant\",\n        \"bar\",\n        \"internet-cafe\",\n        \"bakery-pastry-shop\",\n        \"butcher\",\n        \"hotel\",\n        \"bed-and-breakfast\",\n        \"campsite\",\n        \"holiday-apartment\",\n        \"hairdresser\",\n        \"beauty-center\",\n        \"nail-studio\",\n        \"tattoo\",\n        \"yoga\",\n        \"fitness-center\",\n        \"spa\",\n        \"dentist\",\n        \"doctors\",\n        \"veterinary-practice\",\n        \"pharmacy\",\n        \"optician\",\n        \"physical-therapy\",\n        \"chiropractor\",\n        \"orthodontics\",\n        \"gynaecology-and-obstetrics\",\n        \"attorneys-at-law\",\n        \"lawyers-office\",\n        \"notary-public\",\n        \"law-firm-notary-public\",\n        \"tax-advice\",\n        \"tax-experts\",\n        \"audit-firm\",\n        \"accounting\",\n        \"consulting-office\",\n        \"architectural-firm\",\n        \"engineering-firms\",\n        \"construction-company\",\n        \"carpenter\",\n        \"electric-installations\",\n        \"sanitary-facilities\",\n        \"car-body-work\",\n        \"car-dealership\",\n        \"car-rentals\",\n        \"real-estate\",\n        \"insurance\",\n        \"bank-savings-bank\",\n        \"cleaning-company\",\n        \"laundry-service\",\n        \"international-moving\",\n        \"employment-agency\",\n        \"translations\",\n        \"web-design\",\n        \"aerial-photography\",\n        \"boutique\",\n        \"shoes\",\n        \"jeweler\",\n        \"bookstore\",\n        \"toys\",\n        \"electronics\",\n        \"furniture-factory\",\n        \"garden-center\",\n        \"hardware\",\n        \"florist\",\n        \"confectioners\",\n        \"ice-cream-parlors\",\n        \"pizzeria\",\n        \"casinos\",\n        \"concerts\",\n        \"art-school\",\n        \"language-schools\",\n        \"automobile-driving-school\",\n        \"kindergarten\",\n        \"acupoint-massage\",\n        \"nightclub\",\n        \"cinema\"\n      ],\n      \"enumTitles\": [\n        \"Custom category (type below)\",\n        \"Restaurants\",\n        \"Bar\",\n        \"Internet cafe\",\n        \"Bakery / pastry shop\",\n        \"Butcher\",\n        \"Hotels\",\n        \"Bed and Breakfast\",\n        \"Campsite\",\n        \"Holiday apartment\",\n        \"Hairdresser\",\n        \"Beauty center\",\n        \"Nail studio\",\n        \"Tattoo\",\n        \"Yoga\",\n        \"Fitness center\",\n        \"Spa\",\n        \"Dentist\",\n        \"Doctors\",\n        \"Veterinary practice\",\n        \"Pharmacy\",\n        \"Optician\",\n        \"Physical therapy\",\n        \"Chiropractor\",\n        \"Orthodontics\",\n        \"Gynaecology and obstetrics\",\n        \"Attorneys at law\",\n        \"Lawyers office\",\n        \"Notary public\",\n        \"Law firm / Notary public\",\n        \"Tax advice\",\n        \"Tax experts\",\n        \"Audit firm\",\n        \"Accounting\",\n        \"Consulting office\",\n        \"Architectural firm\",\n        \"Engineering firms\",\n        \"Construction company\",\n        \"Carpenter\",\n        \"Electricians\",\n        \"Plumber (sanitary facilities)\",\n        \"Car body work\",\n        \"Car dealership\",\n        \"Car rentals\",\n        \"Real estate\",\n        \"Insurance\",\n        \"Bank / savings bank\",\n        \"Cleaning company\",\n        \"Laundry service\",\n        \"International moving\",\n        \"Employment agency\",\n        \"Translations\",\n        \"Web design\",\n        \"Aerial photography\",\n        \"Boutique\",\n        \"Shoes\",\n        \"Jeweler\",\n        \"Bookstore\",\n        \"Toys\",\n        \"Electronics\",\n        \"Furniture factory\",\n        \"Garden center\",\n        \"Hardware\",\n        \"Florist\",\n        \"Confectioners\",\n        \"Ice cream parlors\",\n        \"Pizzeria\",\n        \"Casinos\",\n        \"Concerts\",\n        \"Art school\",\n        \"Language schools\",\n        \"Automobile driving school\",\n        \"Kindergarten\",\n        \"Massage\",\n        \"Nightclub\",\n        \"Cinema\"\n      ],\n      \"default\": \"restaurant\",\n      \"prefill\": \"restaurant\"\n    },\n    \"customCategory\": {\n      \"title\": \"Custom category (overrides selection above)\",\n      \"type\": \"string\",\n      \"description\": \"Free-text category not in the curated list above, e.g. 'Locksmith' or 'IT services' (mode=search). Takes priority over 'Category' when set. local.ch matches this like a keyword search, so most English/German/French/Italian business terms work.\",\n      \"editor\": \"textfield\"\n    },\n    \"location\": {\n      \"title\": \"City or canton\",\n      \"type\": \"string\",\n      \"description\": \"Swiss city, town, or canton to search in, e.g. 'Zurich', 'Geneva', 'Lugano', 'Basel'. Overridden by 'Canton' below when that is set (mode=search).\",\n      \"editor\": \"textfield\",\n      \"default\": \"Zurich\",\n      \"prefill\": \"Zurich\"\n    },\n    \"canton\": {\n      \"title\": \"Canton (overrides city/canton above)\",\n      \"type\": \"string\",\n      \"description\": \"Search an entire Swiss canton instead of a single city. Takes priority over 'City or canton' when set (mode=search).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"\",\n        \"zurich\",\n        \"bern\",\n        \"lucerne\",\n        \"uri\",\n        \"schwyz\",\n        \"obwalden\",\n        \"nidwalden\",\n        \"glarus\",\n        \"zug\",\n        \"fribourg\",\n        \"solothurn\",\n        \"basel-stadt\",\n        \"basel-landschaft\",\n        \"schaffhausen\",\n        \"appenzell-ausserrhoden\",\n        \"appenzell-innerrhoden\",\n        \"st-gallen\",\n        \"graubuenden\",\n        \"aargau\",\n        \"thurgau\",\n        \"ticino\",\n        \"vaud\",\n        \"valais\",\n        \"neuchatel\",\n        \"geneva\",\n        \"jura\"\n      ],\n      \"enumTitles\": [\n        \"No canton filter (use city above)\",\n        \"Zurich (ZH)\",\n        \"Bern (BE)\",\n        \"Lucerne (LU)\",\n        \"Uri (UR)\",\n        \"Schwyz (SZ)\",\n        \"Obwalden (OW)\",\n        \"Nidwalden (NW)\",\n        \"Glarus (GL)\",\n        \"Zug (ZG)\",\n        \"Fribourg (FR)\",\n        \"Solothurn (SO)\",\n        \"Basel-Stadt (BS)\",\n        \"Basel-Landschaft (BL)\",\n        \"Schaffhausen (SH)\",\n        \"Appenzell Ausserrhoden (AR)\",\n        \"Appenzell Innerrhoden (AI)\",\n        \"St. Gallen (SG)\",\n        \"Graubuenden / Grisons (GR)\",\n        \"Aargau (AG)\",\n        \"Thurgau (TG)\",\n        \"Ticino (TI)\",\n        \"Vaud (VD)\",\n        \"Valais (VS)\",\n        \"Neuchatel (NE)\",\n        \"Geneva (GE)\",\n        \"Jura (JU)\"\n      ],\n      \"default\": \"\",\n      \"prefill\": \"\"\n    },\n    \"language\": {\n      \"title\": \"Site language\",\n      \"type\": \"string\",\n      \"description\": \"Language edition of local.ch to scrape from. Same underlying business data; affects category/label translations in the raw page (does not change output field names).\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"en\",\n        \"de\",\n        \"fr\",\n        \"it\"\n      ],\n      \"enumTitles\": [\n        \"English\",\n        \"German (Deutsch)\",\n        \"French (Francais)\",\n        \"Italian (Italiano)\"\n      ],\n      \"default\": \"en\",\n      \"prefill\": \"en\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort order\",\n      \"type\": \"string\",\n      \"description\": \"How to order search results after fetching (mode=search). local.ch itself only returns relevance order, so 'rating' and 'name' are applied client-side across the fetched batch.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"rating\",\n        \"name\"\n      ],\n      \"enumTitles\": [\n        \"Relevance (local.ch's own order)\",\n        \"Rating (highest rated first)\",\n        \"Name (A-Z)\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"openNowOnly\": {\n      \"title\": \"Open now only\",\n      \"type\": \"boolean\",\n      \"description\": \"Only return businesses that are currently open, based on local.ch's own open/closed badge (mode=search).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"minRating\": {\n      \"title\": \"Minimum rating\",\n      \"type\": \"integer\",\n      \"description\": \"Only return businesses rated at least this many stars, e.g. 4 for 4.0+ (mode=search). 0 means no minimum. Applied client-side; businesses with no rating are excluded once this is set above 0.\",\n      \"minimum\": 0,\n      \"maximum\": 5,\n      \"default\": 0,\n      \"prefill\": 0\n    },\n    \"fetchDetails\": {\n      \"title\": \"Fetch full business profiles\",\n      \"type\": \"boolean\",\n      \"description\": \"For each search result, also visit its business profile page to collect email, website, social links, precise coordinates, full opening hours, and photos. Slower -- one extra request per result (mode=search).\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"businessUrls\": {\n      \"title\": \"Business profile URLs (mode=detail)\",\n      \"type\": \"array\",\n      \"description\": \"Direct local.ch business profile URLs to fetch, e.g. https://www.local.ch/en/d/zurich/8001/restaurant/some-business-abc123. Use the 'sourceUrl' field from search results.\",\n      \"editor\": \"requestListSources\",\n      \"items\": {\n        \"type\": \"object\",\n        \"properties\": {\n          \"url\": {\n            \"type\": \"string\",\n            \"description\": \"local.ch business profile URL.\",\n            \"title\": \"URL\"\n          }\n        }\n      },\n      \"default\": [],\n      \"prefill\": []\n    },\n    \"maxItems\": {\n      \"title\": \"Max items\",\n      \"type\": \"integer\",\n      \"description\": \"Hard cap on the number of business records to return.\",\n      \"minimum\": 1,\n      \"maximum\": 1000,\n      \"default\": 20,\n      \"prefill\": 20\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# local.ch Business Finder by Canton & Category\n\nlocal.ch is where the Swiss market looks up local businesses by trade and place. This actor runs the same category-plus-location search — across any city or one of the 26 cantons — and can follow through to each business's own profile page for email, social links, precise GPS coordinates, structured opening hours, and photos. No login, no cookies, no API key required.\n\n## What this actor does\n\n- **Two modes:** `search` (category + city/canton) and `detail` (direct business profile URLs)\n- **75 curated categories** to pick from, or type any custom category (local.ch matches free text like a keyword search)\n- **All 26 Swiss cantons** available as a one-click filter, in addition to free-text city search\n- **4 languages** — English, German, French, Italian (same underlying data, localized labels)\n- **Sort by** relevance, rating, or name (A-Z)\n- **Filter by** \"open now\" or minimum star rating (1-5)\n- **Full Swiss character support** — ü, é, à, ç etc. are handled correctly in both input and output\n- **Rich business profiles** — GPS coordinates, structured opening hours, email, website, Facebook/Instagram/LinkedIn/Twitter/YouTube links, photos, logo\n- **Empty fields are omitted** — you only ever see fields that were actually found for a business\n\n## Output per business\n\n- `businessId` — local.ch's internal business identifier\n- `name` — business name\n- `subtitle` — short business-provided subtitle shown under the name (sometimes a legal entity name, sometimes a tagline; when profile fetched)\n- `category` — primary listed category, `categories[]` — all registered categories (mode=search)\n- `rating`, `ratingCount` — average star rating (1-5) and total number of ratings\n- `reviewCount` — number of written reviews (when profile fetched; distinct from `ratingCount`, which includes star-only ratings)\n- `street`, `zipCode`, `city`, `country`\n- `latitude`, `longitude` — precise GPS coordinates (when profile fetched)\n- `isOpenNow` — live open/closed status from the search listing\n- `openingHours[]` — structured opening hours (`{day, opens, closes}` per slot; when profile fetched and the business publishes schema.org hours)\n- `phone`, `email`, `website`\n- `facebookUrl`, `instagramUrl`, `linkedinUrl`, `twitterUrl`, `youtubeUrl` — social links the business has published (when profile fetched)\n- `thumbnailUrl` — small logo/photo thumbnail shown on the search-results card (mode=search, no `fetchDetails` needed)\n- `images[]` (up to 15), `logoUrl` — business photos and logo (when profile fetched)\n- `searchCategory`, `searchLocation`, `language` — the search parameters used (mode=search)\n- `sourceUrl` — canonical local.ch profile URL for the business\n- `recordType: \"business\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string (select) | `search` | `search` (category + city/canton) or `detail` (fetch by URL) |\n| `category` | string (select) | `restaurant` | Pick a common category, or `custom` to use `customCategory` (mode=search) |\n| `customCategory` | string | – | Any free-text category, overrides `category` (mode=search) |\n| `location` | string | `Zurich` | Swiss city or canton name to search in (mode=search) |\n| `canton` | string (select) | – | Pick one of the 26 Swiss cantons to search the whole canton instead of `location` |\n| `language` | string (select) | `en` | Site language: `en`, `de`, `fr`, `it` |\n| `sortBy` | string (select) | `relevance` | `relevance` / `rating` (highest first) / `name` (A-Z) — applied client-side across the fetched batch |\n| `openNowOnly` | boolean | `false` | Only return businesses currently open |\n| `minRating` | integer | `0` (no minimum) | Only return businesses rated at least 1-5 stars |\n| `fetchDetails` | boolean | `false` | Also visit each business's profile page for richer data (slower) |\n| `businessUrls` | array | – | local.ch profile URLs to fetch directly (mode=detail) |\n| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |\n\n### Example: search restaurants in Zurich\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restaurant\",\n  \"location\": \"Zurich\",\n  \"maxItems\": 20\n}\n```\n\n### Example: highest-rated dentists in Geneva, with full profiles\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"dentist\",\n  \"location\": \"Geneva\",\n  \"sortBy\": \"rating\",\n  \"fetchDetails\": true,\n  \"maxItems\": 30\n}\n```\n\n### Example: 4+ star restaurants open right now across all of Ticino canton\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restaurant\",\n  \"canton\": \"ticino\",\n  \"openNowOnly\": true,\n  \"minRating\": 4,\n  \"maxItems\": 50\n}\n```\n\n### Example: lawyers across the whole of Switzerland, A-Z, in French\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"attorneys-at-law\",\n  \"location\": \"Switzerland\",\n  \"language\": \"fr\",\n  \"sortBy\": \"name\",\n  \"maxItems\": 100\n}\n```\n\n### Example: fetch specific business profiles\n\n```json\n{\n  \"mode\": \"detail\",\n  \"businessUrls\": [\n    { \"url\": \"https://www.local.ch/en/d/zurich/8001/restaurant/george-bar-grill-E2FE14_t_A8FFW9_xUkXBQ\" }\n  ]\n}\n```\n\n## Use cases\n\n- **Local lead generation** — build a prospect list of Swiss businesses by trade and city/canton for B2B outreach\n- **Market research** — measure business density and average ratings for a category across Swiss regions\n- **Directory aggregation** — feed structured Swiss business data into your own local-search product\n- **Competitor mapping** — see who else operates in a category and area, with ratings and contact info\n- **Franchise & site-selection analysis** — evaluate service-business coverage across cantons and cities\n\n## Limitations\n\n- **Deep pagination on very broad searches.** local.ch enforces a per-IP rate limit on its search-results pages of roughly 9 page requests before returning 403s (confirmed via testing: this triggers at a fixed request count, not a request-rate/time window). In practice this caps a single run at roughly 150-180 records for very broad, single-category-nationwide searches (e.g. `category: \"restaurant\"`, `location: \"Switzerland\"`). The actor automatically rotates through Apify's free AUTO proxy to recover from this where possible and always returns every record it collected before the limit hit (never an empty/failed run). For larger volumes, run multiple smaller searches (e.g. one per city or canton) instead of one very broad nationwide pull — city- and canton-scoped searches rarely reach this limit.\n- **`sortBy` is applied client-side.** local.ch's search-results pages don't honor a server-side sort parameter (verified: `?sort=rating` returns results in the same order as no sort parameter), so `rating`/`name` sorting is applied across the batch of records this run actually fetched, not the entire category.\n- **`openNowOnly` and `minRating` are applied client-side.** A business with no open/closed badge or no rating on local.ch is only excluded by `minRating` (which requires a rating to compare against); it is *not* excluded by `openNowOnly`, since an unknown status is treated as \"don't filter this one out\" rather than \"closed\".\n\n## FAQ\n\n**What data source does this actor use?**\nIt reads the publicly available search and business-profile pages on local.ch, Switzerland's leading business directory. No account or API key is needed.\n\n**Is this affiliated with local.ch?**\nNo. This is an independent, third-party actor that reads publicly accessible pages.\n\n**Why do some businesses have no rating, phone, or website?**\nlocal.ch only shows a rating once a business has received at least one review, and only shows contact/social details a business itself provided. Fields with no data are simply omitted from the record rather than shown as empty or null.\n\n**What's the difference between `ratingCount` and `reviewCount`?**\n`ratingCount` is the total number of star ratings a business has received. `reviewCount` is the (usually smaller) number of ratings that include a written review. Both come directly from local.ch's own aggregate rating data.\n\n**Can I search a whole canton instead of a single city?**\nYes — set `canton` to any of the 26 Swiss cantons; it takes priority over `location`. You can also just type a canton name (e.g. `\"Vaud\"`) directly into `location`.\n\n**Can I search all of Switzerland at once?**\nYes — set `location` to `\"Switzerland\"` (or leave both `location`/`canton` and just rely on the default) for a nationwide search.\n\n**How accurate are the GPS coordinates?**\n`latitude`/`longitude` come directly from the business's own local.ch profile page (only available with `fetchDetails: true` in search mode, or always in `detail` mode).\n\n**Why is `fetchDetails` off by default?**\nFetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need email, website, social links, coordinates, structured opening hours, or photos.\n\n**Does this actor need a proxy or login?**\nNo — local.ch's search and profile pages are served without any anti-bot challenge, so this actor runs entirely on Apify's free plan with no proxy and no credentials.\n\n**What does `subtitle` mean?**\nlocal.ch lets businesses show a short line under their name. For registered companies this is often their legal entity name (e.g. `\"Selnau Gastro AG\"`); for others it can be a marketing tagline or keyword list. It's included as-is since we can't reliably tell the two apart.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "local-ch-business-finder-by-canton-and-category",
      "title": "local.ch Business Finder by Canton & Category",
      "description": "Search local.ch by business category and Swiss city or canton, or fetch full business profiles by direct URL, for names, addresses, phone numbers, ratings, opening hours, coordinates and social links.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# local.ch Business Finder by Canton & Category\n\nlocal.ch is where the Swiss market looks up local businesses by trade and place. This actor runs the same category-plus-location search — across any city or one of the 26 cantons — and can follow through to each business's own profile page for email, social links, precise GPS coordinates, structured opening hours, and photos. No login, no cookies, no API key required.\n\n## What this actor does\n\n- **Two modes:** `search` (category + city/canton) and `detail` (direct business profile URLs)\n- **75 curated categories** to pick from, or type any custom category (local.ch matches free text like a keyword search)\n- **All 26 Swiss cantons** available as a one-click filter, in addition to free-text city search\n- **4 languages** — English, German, French, Italian (same underlying data, localized labels)\n- **Sort by** relevance, rating, or name (A-Z)\n- **Filter by** \"open now\" or minimum star rating (1-5)\n- **Full Swiss character support** — ü, é, à, ç etc. are handled correctly in both input and output\n- **Rich business profiles** — GPS coordinates, structured opening hours, email, website, Facebook/Instagram/LinkedIn/Twitter/YouTube links, photos, logo\n- **Empty fields are omitted** — you only ever see fields that were actually found for a business\n\n## Output per business\n\n- `businessId` — local.ch's internal business identifier\n- `name` — business name\n- `subtitle` — short business-provided subtitle shown under the name (sometimes a legal entity name, sometimes a tagline; when profile fetched)\n- `category` — primary listed category, `categories[]` — all registered categories (mode=search)\n- `rating`, `ratingCount` — average star rating (1-5) and total number of ratings\n- `reviewCount` — number of written reviews (when profile fetched; distinct from `ratingCount`, which includes star-only ratings)\n- `street`, `zipCode`, `city`, `country`\n- `latitude`, `longitude` — precise GPS coordinates (when profile fetched)\n- `isOpenNow` — live open/closed status from the search listing\n- `openingHours[]` — structured opening hours (`{day, opens, closes}` per slot; when profile fetched and the business publishes schema.org hours)\n- `phone`, `email`, `website`\n- `facebookUrl`, `instagramUrl`, `linkedinUrl`, `twitterUrl`, `youtubeUrl` — social links the business has published (when profile fetched)\n- `thumbnailUrl` — small logo/photo thumbnail shown on the search-results card (mode=search, no `fetchDetails` needed)\n- `images[]` (up to 15), `logoUrl` — business photos and logo (when profile fetched)\n- `searchCategory`, `searchLocation`, `language` — the search parameters used (mode=search)\n- `sourceUrl` — canonical local.ch profile URL for the business\n- `recordType: \"business\"`, `scrapedAt`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string (select) | `search` | `search` (category + city/canton) or `detail` (fetch by URL) |\n| `category` | string (select) | `restaurant` | Pick a common category, or `custom` to use `customCategory` (mode=search) |\n| `customCategory` | string | – | Any free-text category, overrides `category` (mode=search) |\n| `location` | string | `Zurich` | Swiss city or canton name to search in (mode=search) |\n| `canton` | string (select) | – | Pick one of the 26 Swiss cantons to search the whole canton instead of `location` |\n| `language` | string (select) | `en` | Site language: `en`, `de`, `fr`, `it` |\n| `sortBy` | string (select) | `relevance` | `relevance` / `rating` (highest first) / `name` (A-Z) — applied client-side across the fetched batch |\n| `openNowOnly` | boolean | `false` | Only return businesses currently open |\n| `minRating` | integer | `0` (no minimum) | Only return businesses rated at least 1-5 stars |\n| `fetchDetails` | boolean | `false` | Also visit each business's profile page for richer data (slower) |\n| `businessUrls` | array | – | local.ch profile URLs to fetch directly (mode=detail) |\n| `maxItems` | int | `20` | Hard cap on returned records (1-1000) |\n\n### Example: search restaurants in Zurich\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restaurant\",\n  \"location\": \"Zurich\",\n  \"maxItems\": 20\n}\n```\n\n### Example: highest-rated dentists in Geneva, with full profiles\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"dentist\",\n  \"location\": \"Geneva\",\n  \"sortBy\": \"rating\",\n  \"fetchDetails\": true,\n  \"maxItems\": 30\n}\n```\n\n### Example: 4+ star restaurants open right now across all of Ticino canton\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"restaurant\",\n  \"canton\": \"ticino\",\n  \"openNowOnly\": true,\n  \"minRating\": 4,\n  \"maxItems\": 50\n}\n```\n\n### Example: lawyers across the whole of Switzerland, A-Z, in French\n\n```json\n{\n  \"mode\": \"search\",\n  \"category\": \"attorneys-at-law\",\n  \"location\": \"Switzerland\",\n  \"language\": \"fr\",\n  \"sortBy\": \"name\",\n  \"maxItems\": 100\n}\n```\n\n### Example: fetch specific business profiles\n\n```json\n{\n  \"mode\": \"detail\",\n  \"businessUrls\": [\n    { \"url\": \"https://www.local.ch/en/d/zurich/8001/restaurant/george-bar-grill-E2FE14_t_A8FFW9_xUkXBQ\" }\n  ]\n}\n```\n\n## Use cases\n\n- **Local lead generation** — build a prospect list of Swiss businesses by trade and city/canton for B2B outreach\n- **Market research** — measure business density and average ratings for a category across Swiss regions\n- **Directory aggregation** — feed structured Swiss business data into your own local-search product\n- **Competitor mapping** — see who else operates in a category and area, with ratings and contact info\n- **Franchise & site-selection analysis** — evaluate service-business coverage across cantons and cities\n\n## Limitations\n\n- **Deep pagination on very broad searches.** local.ch enforces a per-IP rate limit on its search-results pages of roughly 9 page requests before returning 403s (confirmed via testing: this triggers at a fixed request count, not a request-rate/time window). In practice this caps a single run at roughly 150-180 records for very broad, single-category-nationwide searches (e.g. `category: \"restaurant\"`, `location: \"Switzerland\"`). The actor automatically rotates through Apify's free AUTO proxy to recover from this where possible and always returns every record it collected before the limit hit (never an empty/failed run). For larger volumes, run multiple smaller searches (e.g. one per city or canton) instead of one very broad nationwide pull — city- and canton-scoped searches rarely reach this limit.\n- **`sortBy` is applied client-side.** local.ch's search-results pages don't honor a server-side sort parameter (verified: `?sort=rating` returns results in the same order as no sort parameter), so `rating`/`name` sorting is applied across the batch of records this run actually fetched, not the entire category.\n- **`openNowOnly` and `minRating` are applied client-side.** A business with no open/closed badge or no rating on local.ch is only excluded by `minRating` (which requires a rating to compare against); it is *not* excluded by `openNowOnly`, since an unknown status is treated as \"don't filter this one out\" rather than \"closed\".\n\n## FAQ\n\n**What data source does this actor use?**\nIt reads the publicly available search and business-profile pages on local.ch, Switzerland's leading business directory. No account or API key is needed.\n\n**Is this affiliated with local.ch?**\nNo. This is an independent, third-party actor that reads publicly accessible pages.\n\n**Why do some businesses have no rating, phone, or website?**\nlocal.ch only shows a rating once a business has received at least one review, and only shows contact/social details a business itself provided. Fields with no data are simply omitted from the record rather than shown as empty or null.\n\n**What's the difference between `ratingCount` and `reviewCount`?**\n`ratingCount` is the total number of star ratings a business has received. `reviewCount` is the (usually smaller) number of ratings that include a written review. Both come directly from local.ch's own aggregate rating data.\n\n**Can I search a whole canton instead of a single city?**\nYes — set `canton` to any of the 26 Swiss cantons; it takes priority over `location`. You can also just type a canton name (e.g. `\"Vaud\"`) directly into `location`.\n\n**Can I search all of Switzerland at once?**\nYes — set `location` to `\"Switzerland\"` (or leave both `location`/`canton` and just rely on the default) for a nationwide search.\n\n**How accurate are the GPS coordinates?**\n`latitude`/`longitude` come directly from the business's own local.ch profile page (only available with `fetchDetails: true` in search mode, or always in `detail` mode).\n\n**Why is `fetchDetails` off by default?**\nFetching each business's full profile page requires one extra request per result, which is slower. Turn it on when you need email, website, social links, coordinates, structured opening hours, or photos.\n\n**Does this actor need a proxy or login?**\nNo — local.ch's search and profile pages are served without any anti-bot challenge, so this actor runs entirely on Apify's free plan with no proxy and no credentials.\n\n**What does `subtitle` mean?**\nlocal.ch lets businesses show a short line under their name. For registered companies this is often their legal entity name (e.g. `\"Selnau Gastro AG\"`); for others it can be a marketing tagline or keyword list. It's included as-is since we can't reliably tell the two apart.\n",
      "input": {
        "title": "local.ch Scraper Input",
        "description": "Search local.ch (Switzerland's leading business directory) by category and city/canton, or fetch full business profiles by direct URL.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to fetch: search a category + city/canton, or fetch full business profiles from direct local.ch URLs.",
            "editor": "select",
            "enum": [
              "search",
              "detail"
            ],
            "enumTitles": [
              "Search by category & city/canton",
              "Fetch business profiles by URL"
            ],
            "default": "search",
            "prefill": "search"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Business category to search for. Pick a common category, or choose 'Custom category' and type your own below (mode=search).",
            "editor": "select",
            "enum": [
              "custom",
              "restaurant",
              "bar",
              "internet-cafe",
              "bakery-pastry-shop",
              "butcher",
              "hotel",
              "bed-and-breakfast",
              "campsite",
              "holiday-apartment",
              "hairdresser",
              "beauty-center",
              "nail-studio",
              "tattoo",
              "yoga",
              "fitness-center",
              "spa",
              "dentist",
              "doctors",
              "veterinary-practice",
              "pharmacy",
              "optician",
              "physical-therapy",
              "chiropractor",
              "orthodontics",
              "gynaecology-and-obstetrics",
              "attorneys-at-law",
              "lawyers-office",
              "notary-public",
              "law-firm-notary-public",
              "tax-advice",
              "tax-experts",
              "audit-firm",
              "accounting",
              "consulting-office",
              "architectural-firm",
              "engineering-firms",
              "construction-company",
              "carpenter",
              "electric-installations",
              "sanitary-facilities",
              "car-body-work",
              "car-dealership",
              "car-rentals",
              "real-estate",
              "insurance",
              "bank-savings-bank",
              "cleaning-company",
              "laundry-service",
              "international-moving",
              "employment-agency",
              "translations",
              "web-design",
              "aerial-photography",
              "boutique",
              "shoes",
              "jeweler",
              "bookstore",
              "toys",
              "electronics",
              "furniture-factory",
              "garden-center",
              "hardware",
              "florist",
              "confectioners",
              "ice-cream-parlors",
              "pizzeria",
              "casinos",
              "concerts",
              "art-school",
              "language-schools",
              "automobile-driving-school",
              "kindergarten",
              "acupoint-massage",
              "nightclub",
              "cinema"
            ],
            "enumTitles": [
              "Custom category (type below)",
              "Restaurants",
              "Bar",
              "Internet cafe",
              "Bakery / pastry shop",
              "Butcher",
              "Hotels",
              "Bed and Breakfast",
              "Campsite",
              "Holiday apartment",
              "Hairdresser",
              "Beauty center",
              "Nail studio",
              "Tattoo",
              "Yoga",
              "Fitness center",
              "Spa",
              "Dentist",
              "Doctors",
              "Veterinary practice",
              "Pharmacy",
              "Optician",
              "Physical therapy",
              "Chiropractor",
              "Orthodontics",
              "Gynaecology and obstetrics",
              "Attorneys at law",
              "Lawyers office",
              "Notary public",
              "Law firm / Notary public",
              "Tax advice",
              "Tax experts",
              "Audit firm",
              "Accounting",
              "Consulting office",
              "Architectural firm",
              "Engineering firms",
              "Construction company",
              "Carpenter",
              "Electricians",
              "Plumber (sanitary facilities)",
              "Car body work",
              "Car dealership",
              "Car rentals",
              "Real estate",
              "Insurance",
              "Bank / savings bank",
              "Cleaning company",
              "Laundry service",
              "International moving",
              "Employment agency",
              "Translations",
              "Web design",
              "Aerial photography",
              "Boutique",
              "Shoes",
              "Jeweler",
              "Bookstore",
              "Toys",
              "Electronics",
              "Furniture factory",
              "Garden center",
              "Hardware",
              "Florist",
              "Confectioners",
              "Ice cream parlors",
              "Pizzeria",
              "Casinos",
              "Concerts",
              "Art school",
              "Language schools",
              "Automobile driving school",
              "Kindergarten",
              "Massage",
              "Nightclub",
              "Cinema"
            ],
            "default": "restaurant",
            "prefill": "restaurant"
          },
          "customCategory": {
            "title": "Custom category (overrides selection above)",
            "type": "string",
            "description": "Free-text category not in the curated list above, e.g. 'Locksmith' or 'IT services' (mode=search). Takes priority over 'Category' when set. local.ch matches this like a keyword search, so most English/German/French/Italian business terms work.",
            "editor": "textfield"
          },
          "location": {
            "title": "City or canton",
            "type": "string",
            "description": "Swiss city, town, or canton to search in, e.g. 'Zurich', 'Geneva', 'Lugano', 'Basel'. Overridden by 'Canton' below when that is set (mode=search).",
            "editor": "textfield",
            "default": "Zurich",
            "prefill": "Zurich"
          },
          "canton": {
            "title": "Canton (overrides city/canton above)",
            "type": "string",
            "description": "Search an entire Swiss canton instead of a single city. Takes priority over 'City or canton' when set (mode=search).",
            "editor": "select",
            "enum": [
              "",
              "zurich",
              "bern",
              "lucerne",
              "uri",
              "schwyz",
              "obwalden",
              "nidwalden",
              "glarus",
              "zug",
              "fribourg",
              "solothurn",
              "basel-stadt",
              "basel-landschaft",
              "schaffhausen",
              "appenzell-ausserrhoden",
              "appenzell-innerrhoden",
              "st-gallen",
              "graubuenden",
              "aargau",
              "thurgau",
              "ticino",
              "vaud",
              "valais",
              "neuchatel",
              "geneva",
              "jura"
            ],
            "enumTitles": [
              "No canton filter (use city above)",
              "Zurich (ZH)",
              "Bern (BE)",
              "Lucerne (LU)",
              "Uri (UR)",
              "Schwyz (SZ)",
              "Obwalden (OW)",
              "Nidwalden (NW)",
              "Glarus (GL)",
              "Zug (ZG)",
              "Fribourg (FR)",
              "Solothurn (SO)",
              "Basel-Stadt (BS)",
              "Basel-Landschaft (BL)",
              "Schaffhausen (SH)",
              "Appenzell Ausserrhoden (AR)",
              "Appenzell Innerrhoden (AI)",
              "St. Gallen (SG)",
              "Graubuenden / Grisons (GR)",
              "Aargau (AG)",
              "Thurgau (TG)",
              "Ticino (TI)",
              "Vaud (VD)",
              "Valais (VS)",
              "Neuchatel (NE)",
              "Geneva (GE)",
              "Jura (JU)"
            ],
            "default": "",
            "prefill": ""
          },
          "language": {
            "title": "Site language",
            "type": "string",
            "description": "Language edition of local.ch to scrape from. Same underlying business data; affects category/label translations in the raw page (does not change output field names).",
            "editor": "select",
            "enum": [
              "en",
              "de",
              "fr",
              "it"
            ],
            "enumTitles": [
              "English",
              "German (Deutsch)",
              "French (Francais)",
              "Italian (Italiano)"
            ],
            "default": "en",
            "prefill": "en"
          },
          "sortBy": {
            "title": "Sort order",
            "type": "string",
            "description": "How to order search results after fetching (mode=search). local.ch itself only returns relevance order, so 'rating' and 'name' are applied client-side across the fetched batch.",
            "editor": "select",
            "enum": [
              "relevance",
              "rating",
              "name"
            ],
            "enumTitles": [
              "Relevance (local.ch's own order)",
              "Rating (highest rated first)",
              "Name (A-Z)"
            ],
            "default": "relevance",
            "prefill": "relevance"
          },
          "openNowOnly": {
            "title": "Open now only",
            "type": "boolean",
            "description": "Only return businesses that are currently open, based on local.ch's own open/closed badge (mode=search).",
            "default": false,
            "prefill": false
          },
          "minRating": {
            "title": "Minimum rating",
            "type": "integer",
            "description": "Only return businesses rated at least this many stars, e.g. 4 for 4.0+ (mode=search). 0 means no minimum. Applied client-side; businesses with no rating are excluded once this is set above 0.",
            "minimum": 0,
            "maximum": 5,
            "default": 0,
            "prefill": 0
          },
          "fetchDetails": {
            "title": "Fetch full business profiles",
            "type": "boolean",
            "description": "For each search result, also visit its business profile page to collect email, website, social links, precise coordinates, full opening hours, and photos. Slower -- one extra request per result (mode=search).",
            "default": false,
            "prefill": false
          },
          "businessUrls": {
            "title": "Business profile URLs (mode=detail)",
            "type": "array",
            "description": "Direct local.ch business profile URLs to fetch, e.g. https://www.local.ch/en/d/zurich/8001/restaurant/some-business-abc123. Use the 'sourceUrl' field from search results.",
            "editor": "requestListSources",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "local.ch business profile URL.",
                  "title": "URL"
                }
              }
            },
            "default": [],
            "prefill": []
          },
          "maxItems": {
            "title": "Max items",
            "type": "integer",
            "description": "Hard cap on the number of business records to return.",
            "minimum": 1,
            "maximum": 1000,
            "default": 20,
            "prefill": 20
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "local.ch Business Finder by Canton & Category Output",
        "description": "One record per local.ch business, with address, rating, opening hours, coordinates and social links by category and canton.",
        "properties": {
          "businesses": {
            "type": "string",
            "title": "local.ch businesses",
            "description": "Dataset containing all scraped local.ch business listings.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Businesses",
              "transformation": {
                "fields": [
                  "name",
                  "category",
                  "city",
                  "street",
                  "phone",
                  "rating",
                  "reviewCount",
                  "website",
                  "sourceUrl"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.1",
    "imageDigest": "8f1337506cb19b553e32e5dee15384e56dfa8c5fea6ae2e0f9b703793fde83b2",
    "actVersion": {
      "sourceType": "TARBALL",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.010806666666666666
    }
  }
}