{
  "openapi": "3.0.1",
  "info": {
    "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",
    "x-build-id": "fI87q4jQj6qFsi2hf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nimbryxo-studio~local-ch-business-finder-by-canton-and-category/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nimbryxo-studio-local-ch-business-finder-by-canton-and-category",
        "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/nimbryxo-studio~local-ch-business-finder-by-canton-and-category/runs": {
      "post": {
        "operationId": "runs-sync-nimbryxo-studio-local-ch-business-finder-by-canton-and-category",
        "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/nimbryxo-studio~local-ch-business-finder-by-canton-and-category/run-sync": {
      "post": {
        "operationId": "run-sync-nimbryxo-studio-local-ch-business-finder-by-canton-and-category",
        "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": "Mode",
            "enum": [
              "search",
              "detail"
            ],
            "type": "string",
            "description": "What to fetch: search a category + city/canton, or fetch full business profiles from direct local.ch URLs.",
            "default": "search"
          },
          "category": {
            "title": "Category",
            "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"
            ],
            "type": "string",
            "description": "Business category to search for. Pick a common category, or choose 'Custom category' and type your own below (mode=search).",
            "default": "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."
          },
          "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).",
            "default": "Zurich"
          },
          "canton": {
            "title": "Canton (overrides city/canton above)",
            "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"
            ],
            "type": "string",
            "description": "Search an entire Swiss canton instead of a single city. Takes priority over 'City or canton' when set (mode=search).",
            "default": ""
          },
          "language": {
            "title": "Site language",
            "enum": [
              "en",
              "de",
              "fr",
              "it"
            ],
            "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).",
            "default": "en"
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "relevance",
              "rating",
              "name"
            ],
            "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.",
            "default": "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
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "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.",
            "default": 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
          },
          "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.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": "string",
                  "description": "local.ch business profile URL.",
                  "title": "URL"
                }
              }
            },
            "default": []
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Hard cap on the number of business records to return.",
            "default": 20
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}