# Local.ch $1💰 URL | Keywords | Reviews Scraper (`abotapi/local-ch-scraper`) Actor

From $1/1K. Pull structured company data from local.ch, including name, address, GPS, phone, email, website, hours, ratings, social links, photos, and categories. Search by category and location or use URLs. Supports Deutsch, English, Français, and Italiano.

- **URL**: https://apify.com/abotapi/local-ch-scraper.md
- **Developed by:** [AbotAPI](https://apify.com/abotapi) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## local.ch Scraper

Pull structured company data from **local.ch**, the Swiss directory: name, full street address, GPS coordinates, phone, email, website, opening hours, ratings, social media URLs, photos, and category tags. Two ways to start: search by category and location (city, postal code, canton, or all of Switzerland), or paste local.ch URLs (search or company profiles). Works in Deutsch, English, Français, and Italiano.

### Why this scraper

* **Two start modes plus a review-only switch**: search by category + location, or paste local.ch URLs. Turn on `reviewOnly` to emit review-comment rows instead of listings.
* **Four languages**: pages and category slugs auto-resolve in DE/EN/FR/IT, so `coiffeur` works in French and `friseur` works in German.
* **Five location types**: city slug (`zurich`), 4-digit postal code (`8001`), 2-letter canton (`zh`, `ge`, `vd`), `switzerland`, or all of Switzerland.
* **30+ fields per company**, including phone, mobile, email, website, all social media URLs (Facebook, Instagram, LinkedIn, X, TikTok, Pinterest, YouTube, XING), GPS lat/lng, opening hours per weekday, attribute tags (delivery, takeaway, parking, ...), and full photo galleries.
* **Detail enrichment by default** (toggle via `fetchDetails`): SERP cards alone only carry name + city + postal + category, so the actor visits every profile to pull the rich payload.
* **Optional review comments in listing rows**: turn on `includeReviews` to embed up to 10 review comments per search or URL mode listing.
* **Polymorphic `contactsRaw[]` passthrough**: the full contact polymorphism (MobileContact, LandlineContact, EmailContact, SocialMediaContact, ...) is preserved alongside the flat fields, so future-added contact types still land in the dataset.
* **Tiny footprint**: 256 MB peak memory, runs on the Apify free tier.

### Data you get

> Sample shape, values are illustrative placeholders, not from a live company.

| Field | Example |
| --- | --- |
| `id` | `aaaaaaaaaaaaaaaaaaaaaa` |
| `name` | `Sample Café Zürich` |
| `subtitle` | `Sample Café GmbH` |
| `language` | `de` |
| `isPremium` | `true` |
| `mainCategory` | `Café` |
| `mainCategorySlug` | `cafe` |
| `categories` | `["Café", "Tea room", "Catering"]` |
| `categorySlugs` | `["cafe", "tea-room", "catering"]` |
| `street` | `Sample Street 1` |
| `zipCode` | `8001` |
| `city` | `Zürich` |
| `canton` | `ZH` |
| `country` | `CH` |
| `address` | `Sample Street 1, 8001 Zürich` |
| `latitude` | `47.0000` |
| `longitude` | `8.0000` |
| `phone` | `+41440000000` |
| `mobile` | `+41760000000` |
| `email` | `info@example.com` |
| `website` | `https://example.com/` |
| `whatsapp` | `+41760000000` |
| `facebook` | `https://www.facebook.com/example` |
| `instagram` | `https://www.instagram.com/example` |
| `linkedin` | `https://www.linkedin.com/company/example` |
| `rating` | `4.5` |
| `ratingCount` | `120` |
| `reviewCount` | `60` |
| `reviewsFetched` | `3` |
| `reviews` | `[{ "text": "Great service...", "author": "Reviewer", "date": "2026-01-01" }]` |
| `reviewText` | `Great service and friendly staff. (review mode only)` |
| `openingHours` | `Mon: 09:00-18:00; Tue: 09:00-18:00; Wed: closed; ...` |
| `openingHoursStructured` | `[{ day: "MONDAY", intervals: [{ type: "OPEN", start: "09:00", end: "18:00" }] }, ...]` |
| `description` | `Sample description paragraph appears here when fetchDetails=true.` |
| `attributes` | `["Takeaway", "Delivery", "Vegetarian options"]` |
| `breadcrumb` | `["Home", "Food", "Café"]` |
| `logoUrl` | `https://images.services.local.ch/.../logo.jpg` |
| `imageUrls` | `["https://images.services.local.ch/.../photo-1.jpg", "..."]` |
| `contactsRaw` | full polymorphic contacts array (see Output example) |
| `attributeGroupsRaw` | full upstream attributeGroups array |
| `detailUrl` | `https://www.local.ch/de/d/zurich/8001/cafe/sample-cafe-zurich-aaaaaaaaaaaaaaaaaaaaaa` |
| `searchQuery` | `cafe` |
| `searchWhere` | `zurich` |

### How to use

**Search by category in one city**

```json
{
  "mode": "search",
  "category": "restaurant",
  "where": "zurich",
  "language": "de",
  "maxPages": 5,
  "fetchDetails": true
}
````

**Multi-category sweep across a canton**

```json
{
  "mode": "search",
  "queries": ["restaurant", "hotel", "café"],
  "where": "zh",
  "language": "de",
  "maxListings": 200
}
```

**Search by 4-digit postal code, English UI**

```json
{
  "mode": "search",
  "category": "tea-room",
  "where": "8001",
  "language": "en",
  "maxPages": 3
}
```

**Paste local.ch URLs (search + profile mixed)**

```json
{
  "mode": "url",
  "urls": [
    "https://www.local.ch/de/s/restaurant/zurich",
    "https://www.local.ch/fr/s/restaurant/geneve",
    "https://www.local.ch/en/d/zurich/8001/tea-room/sample-name-aaaaaaaaaaaaaaaaaaaaaa"
  ],
  "maxPages": 3,
  "fetchDetails": true
}
```

**Listing records with review comments embedded**

```json
{
  "mode": "url",
  "urls": [
    "https://www.local.ch/en/d/zurich/8001/tea-room/bonne-maman-boutique-cafe-nVESaL0TOav64BpX8B1Ncg"
  ],
  "includeReviews": true,
  "maxReviewsPerListing": 10
}
```

**Review comments only from pasted profile URLs**

```json
{
  "mode": "url",
  "reviewOnly": true,
  "urls": [
    "https://www.local.ch/en/d/zurich/8001/tea-room/bonne-maman-boutique-cafe-nVESaL0TOav64BpX8B1Ncg"
  ],
  "maxListings": 10
}
```

**Review comments discovered from a category search**

```json
{
  "mode": "search",
  "reviewOnly": true,
  "category": "restaurant",
  "where": "zurich",
  "maxListings": 10
}
```

**Lead-gen filter: only premium-listed companies with both phone and email**

```json
{
  "mode": "search",
  "category": "garage",
  "where": "switzerland",
  "language": "de",
  "premiumOnly": true,
  "withPhone": true,
  "withEmail": true,
  "maxListings": 500
}
```

### Input parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | `search` | `search` (build from category + location) or `url` (use the `urls` list). |
| `reviewOnly` | boolean | `false` | Global output switch. When `true`, emit one row per review comment instead of listing rows. |
| `category` | string | `restaurant` | Single category slug or label. Used in search mode when `queries` is empty. |
| `queries` | array<string> | `[]` | Multiple categories to walk in search mode. Overrides `category`. |
| `where` | string | `zurich` | Location: city slug, 4-digit postal code, 2-letter canton, `switzerland`, or empty. |
| `language` | enum | `de` | `de`, `en`, `fr`, or `it`. Affects URL slugs and content language. |
| `urls` | array<string> | `[]` | local.ch URLs (search or profile pages). Used in URL mode. With `reviewOnly=true`, profile URLs scrape reviews directly and search URLs discover profiles, then scrape reviews. |
| `maxPages` | integer | `3` | Max SERP pages per category/URL. 20 results per page. |
| `maxListings` | integer | `0` | Total cap (0 = unlimited). Multi-query inputs split the cap evenly. |
| `fetchDetails` | boolean | `true` | Visit each profile page for phone, email, GPS, hours, social, attributes. |
| `includeReviews` | boolean | `false` | Include review comments inside each search or URL mode listing record. |
| `maxReviewsPerListing` | integer | `10` | Maximum embedded review comments per listing. Capped at 10. |
| `maxReviewRows` | integer | `10` | Default review-row cap when `reviewOnly=true` and `maxListings` is left at 0. |
| `maxConcurrency` | integer | `6` | Concurrent profile-page fetches. |
| `ratedOnly` | boolean | `false` | Drop entries without an average rating. |
| `minRating` | number | (none) | Drop entries below this rating. |
| `withPhone` | boolean | `false` | Drop entries without a phone number. |
| `withEmail` | boolean | `false` | Drop entries without an email. |
| `withWebsite` | boolean | `false` | Drop entries without a website. |
| `premiumOnly` | boolean | `false` | Keep only premium-listed companies. |
| `proxy` | object | `{ useApifyProxy: true }` | Defaults to Apify's standard connection settings. For large runs, country=CH is recommended. |

### Output example

> Sample record, values are illustrative placeholders, not from a live company.

```json
{
  "id": "aaaaaaaaaaaaaaaaaaaaaa",
  "name": "Sample Café Zürich",
  "subtitle": "Sample Café GmbH",
  "language": "de",
  "isPremium": true,
  "favorited": false,
  "professionalTitle": null,
  "address": "Sample Street 1, 8001 Zürich",
  "street": "Sample Street 1",
  "zipCode": "8001",
  "city": "Zürich",
  "canton": "ZH",
  "country": "CH",
  "latitude": 47.0000,
  "longitude": 8.0000,
  "phone": "+41440000000",
  "phoneAlt": null,
  "mobile": "+41760000000",
  "fax": null,
  "email": "info@example.com",
  "emailAlt": null,
  "website": "https://example.com/",
  "whatsapp": "+41760000000",
  "facebook": "https://www.facebook.com/example",
  "instagram": "https://www.instagram.com/example",
  "linkedin": "https://www.linkedin.com/company/example",
  "twitter": null,
  "tiktok": null,
  "pinterest": null,
  "youtube": null,
  "xing": null,
  "foursquare": null,
  "mainCategory": "Café",
  "mainCategorySlug": "cafe",
  "categories": ["Café", "Tea room", "Catering"],
  "categorySlugs": ["cafe", "tea-room", "catering"],
  "rating": 4.5,
  "ratingCount": 120,
  "reviewCount": 60,
  "reviewsFetched": 2,
  "reviews": [
    {
      "reviewId": "aaaaaaaaaaaaaaaa",
      "title": "Great service",
      "text": "Sample review comment appears here.",
      "date": "2026-01-01T10:00:00Z",
      "author": "Reviewer Name",
      "reply": null
    }
  ],
  "openingHours": "Mon: 09:00-18:00; Tue: 09:00-18:00; Wed: closed; Thu: 09:00-18:00; Fri: 09:00-18:00; Sat: 10:00-17:00; Sun: closed",
  "openingHoursStructured": [
    { "day": "MONDAY", "intervals": [{ "type": "OPEN", "start": "09:00", "end": "18:00" }] }
  ],
  "description": "Sample description paragraph appears here when fetchDetails=true.",
  "descriptionHtml": "<p>Sample description paragraph appears here when fetchDetails=true.</p>",
  "attributes": ["Takeaway", "Delivery", "Vegetarian options"],
  "breadcrumb": ["Home", "Food", "Café"],
  "logoUrl": "https://images.services.local.ch/aaaa/logo.jpg",
  "imageUrls": [
    "https://images.services.local.ch/aaaa/photo-1.jpg",
    "https://images.services.local.ch/aaaa/photo-2.jpg"
  ],
  "contactsRaw": [
    { "__typename": "MobileContact", "value": "+41760000000", "displayValue": "076 000 00 00", "whatsapp": true },
    { "__typename": "EmailContact",  "value": "info@example.com", "displayValue": "info@example.com" },
    { "__typename": "CustomerProvidedURLContact", "value": "https://example.com/", "displayValue": "example.com" },
    { "__typename": "SocialMediaContact", "value": "https://www.facebook.com/example", "socialMediaProvider": "FACEBOOK" }
  ],
  "additionalContactsRaw": null,
  "attributeGroupsRaw": [
    { "groupName": "Services", "attributes": [{ "id": "takeaway", "name": "Takeaway" }] }
  ],
  "detailUrl": "https://www.local.ch/de/d/zurich/8001/cafe/sample-cafe-zurich-aaaaaaaaaaaaaaaaaaaaaa",
  "searchQuery": "cafe",
  "searchWhere": "zurich"
}
```

### Plan requirement

The actor works on every Apify plan including **Free**. For larger runs (thousands of records), the **Apify Starter plan or above** is recommended for the most consistent throughput.

# Actor input Schema

## `mode` (type: `string`):

Choose where the actor should start. Search mode builds searches from category and location. URL mode uses pasted local.ch URLs.

## `reviewOnly` (type: `boolean`):

When ON, output one row per review comment instead of profile listing rows. Works in both search and URL modes.

## `category` (type: `string`):

Used in search mode. Examples: `restaurant`, `coiffeur`, `hairdresser`, `dentist`, `garage`, `hotel`.

## `queries` (type: `array`):

Used in search mode. Optional list of categories to search. When set, this overrides the single `category` field.

## `where` (type: `string`):

Used in search mode. Examples: city slug (`zurich`), postal code (`8001`), canton code (`zh`), or `switzerland`.

## `language` (type: `string`):

Used for URLs and page content. local.ch supports German, English, French, and Italian.

## `urls` (type: `array`):

Used in URL mode. Paste one or more local.ch URLs.
• Search URL: walks result pages
• Profile URL: scrapes one profile page

With `reviewOnly=true`, the actor outputs review comments instead of listing rows.

## `maxPages` (type: `integer`):

Maximum result pages to walk per category or search URL.

## `maxListings` (type: `integer`):

Maximum dataset rows to output. Listing rows when `reviewOnly=false`, review rows when `reviewOnly=true`.

## `fetchDetails` (type: `boolean`):

When ON, enrich listing rows with profile-page fields like phone, email, full address, coordinates, opening hours, social links, and attributes.

## `includeReviews` (type: `boolean`):

Listing output only. Embed review comments inside each listing row. Ignored when `reviewOnly=true`.

## `maxReviewsPerListing` (type: `integer`):

Listing output only. Maximum review comments to embed in each listing row. Values above 10 are capped to 10.

## `maxReviewRows` (type: `integer`):

Review-only output only. Default review-row cap when `reviewOnly=true` and `maxListings=0`.

## `maxConcurrency` (type: `integer`):

How many profile pages to fetch in parallel.

## `ratedOnly` (type: `boolean`):

Listing output only. Keep only listing rows that have an average rating.

## `minRating` (type: `integer`):

Listing output only. Keep only listing rows at or above this rating.

## `withPhone` (type: `boolean`):

Listing output only. Keep only listing rows with a phone number.

## `withEmail` (type: `boolean`):

Listing output only. Keep only listing rows with an email address.

## `withWebsite` (type: `boolean`):

Listing output only. Keep only listing rows with a website.

## `premiumOnly` (type: `boolean`):

Listing output only. Keep only premium-listed profiles.

## `proxy` (type: `object`):

Proxy settings. The default Apify setup works on free plans. For larger runs, country=CH is recommended.

## Actor input object example

```json
{
  "mode": "search",
  "reviewOnly": false,
  "category": "restaurant",
  "queries": [],
  "where": "zurich",
  "language": "de",
  "urls": [
    "https://www.local.ch/de/s/restaurant/zurich"
  ],
  "maxPages": 1,
  "maxListings": 0,
  "fetchDetails": true,
  "includeReviews": false,
  "maxReviewsPerListing": 10,
  "maxReviewRows": 10,
  "maxConcurrency": 6,
  "ratedOnly": false,
  "withPhone": false,
  "withEmail": false,
  "withWebsite": false,
  "premiumOnly": false,
  "proxy": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.local.ch/de/s/restaurant/zurich"
    ],
    "proxy": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/local-ch-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.local.ch/de/s/restaurant/zurich"],
    "proxy": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/local-ch-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": [
    "https://www.local.ch/de/s/restaurant/zurich"
  ],
  "proxy": {
    "useApifyProxy": true
  }
}' |
apify call abotapi/local-ch-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=abotapi/local-ch-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Local.ch $1💰 URL | Keywords | Reviews Scraper",
        "description": "From $1/1K. Pull structured company data from local.ch, including name, address, GPS, phone, email, website, hours, ratings, social links, photos, and categories. Search by category and location or use URLs. Supports Deutsch, English, Français, and Italiano.",
        "version": "0.1",
        "x-build-id": "Hdzuip27InhKBLNC6"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/abotapi~local-ch-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-abotapi-local-ch-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/abotapi~local-ch-scraper/runs": {
            "post": {
                "operationId": "runs-sync-abotapi-local-ch-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/abotapi~local-ch-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-abotapi-local-ch-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",
                "required": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "Run mode",
                        "enum": [
                            "search",
                            "url"
                        ],
                        "type": "string",
                        "description": "Choose where the actor should start. Search mode builds searches from category and location. URL mode uses pasted local.ch URLs.",
                        "default": "search"
                    },
                    "reviewOnly": {
                        "title": "Review-only output",
                        "type": "boolean",
                        "description": "When ON, output one row per review comment instead of profile listing rows. Works in both search and URL modes.",
                        "default": false
                    },
                    "category": {
                        "title": "Category (single)",
                        "type": "string",
                        "description": "Used in search mode. Examples: `restaurant`, `coiffeur`, `hairdresser`, `dentist`, `garage`, `hotel`.",
                        "default": "restaurant"
                    },
                    "queries": {
                        "title": "Categories (multi)",
                        "type": "array",
                        "description": "Used in search mode. Optional list of categories to search. When set, this overrides the single `category` field.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "where": {
                        "title": "Location",
                        "type": "string",
                        "description": "Used in search mode. Examples: city slug (`zurich`), postal code (`8001`), canton code (`zh`), or `switzerland`.",
                        "default": "zurich"
                    },
                    "language": {
                        "title": "Language",
                        "enum": [
                            "de",
                            "en",
                            "fr",
                            "it"
                        ],
                        "type": "string",
                        "description": "Used for URLs and page content. local.ch supports German, English, French, and Italian.",
                        "default": "de"
                    },
                    "urls": {
                        "title": "local.ch URLs",
                        "type": "array",
                        "description": "Used in URL mode. Paste one or more local.ch URLs.\n• Search URL: walks result pages\n• Profile URL: scrapes one profile page\n\nWith `reviewOnly=true`, the actor outputs review comments instead of listing rows.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxPages": {
                        "title": "Maximum pages per search",
                        "minimum": 1,
                        "maximum": 20000,
                        "type": "integer",
                        "description": "Maximum result pages to walk per category or search URL.",
                        "default": 1
                    },
                    "maxListings": {
                        "title": "Maximum rows (0 = unlimited)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum dataset rows to output. Listing rows when `reviewOnly=false`, review rows when `reviewOnly=true`.",
                        "default": 0
                    },
                    "fetchDetails": {
                        "title": "Fetch detail pages",
                        "type": "boolean",
                        "description": "When ON, enrich listing rows with profile-page fields like phone, email, full address, coordinates, opening hours, social links, and attributes.",
                        "default": true
                    },
                    "includeReviews": {
                        "title": "Include review comments",
                        "type": "boolean",
                        "description": "Listing output only. Embed review comments inside each listing row. Ignored when `reviewOnly=true`.",
                        "default": false
                    },
                    "maxReviewsPerListing": {
                        "title": "Maximum reviews per listing",
                        "minimum": 0,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Listing output only. Maximum review comments to embed in each listing row. Values above 10 are capped to 10.",
                        "default": 10
                    },
                    "maxReviewRows": {
                        "title": "Maximum review rows",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Review-only output only. Default review-row cap when `reviewOnly=true` and `maxListings=0`.",
                        "default": 10
                    },
                    "maxConcurrency": {
                        "title": "Max concurrent detail requests",
                        "minimum": 1,
                        "maximum": 20,
                        "type": "integer",
                        "description": "How many profile pages to fetch in parallel.",
                        "default": 6
                    },
                    "ratedOnly": {
                        "title": "Only listings with ratings",
                        "type": "boolean",
                        "description": "Listing output only. Keep only listing rows that have an average rating.",
                        "default": false
                    },
                    "minRating": {
                        "title": "Minimum rating",
                        "minimum": 0,
                        "maximum": 5,
                        "type": "integer",
                        "description": "Listing output only. Keep only listing rows at or above this rating."
                    },
                    "withPhone": {
                        "title": "Only listings with a phone number",
                        "type": "boolean",
                        "description": "Listing output only. Keep only listing rows with a phone number.",
                        "default": false
                    },
                    "withEmail": {
                        "title": "Only listings with an email address",
                        "type": "boolean",
                        "description": "Listing output only. Keep only listing rows with an email address.",
                        "default": false
                    },
                    "withWebsite": {
                        "title": "Only listings with a website",
                        "type": "boolean",
                        "description": "Listing output only. Keep only listing rows with a website.",
                        "default": false
                    },
                    "premiumOnly": {
                        "title": "Only premium-listed companies",
                        "type": "boolean",
                        "description": "Listing output only. Keep only premium-listed profiles.",
                        "default": false
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. The default Apify setup works on free plans. For larger runs, country=CH is recommended.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```