{"openapi":"3.1.0","info":{"title":"KosherWorld public API","version":"1","summary":"Read-only access to the guide's published kosher and Jewish places, by city.","description":"Published places of KosherWorld: kosher restaurants and shops, synagogues, Chabad houses, mikvaot, schools and community institutions, each with its kashrut level as the guide states it. Free to use with attribution: name KosherWorld and link each place you mention to its `url`. Kashrut levels are informational, never a certification; confirm the current certificate with the place. Responses are cached for an hour; requests are rate limited per network (HTTP 429 with Retry-After).","contact":{"email":"hello@kosherworld.app"}},"servers":[{"url":"https://www.kosherworld.app"}],"paths":{"/api/public/cities":{"get":{"operationId":"listCities","summary":"Cities with published places, with counts per category","parameters":[{"$ref":"#/components/parameters/lang"}],"responses":{"200":{"description":"Cities, largest first"}}}},"/api/public/places":{"get":{"operationId":"listPlaces","summary":"One city's published places, filtered and paged","parameters":[{"name":"city","in":"query","required":true,"description":"City slug from /api/public/cities","schema":{"type":"string"}},{"name":"category","in":"query","description":"One or more categories, comma separated","schema":{"type":"string","examples":["restaurante","sinagoga,beit_jabad"]}},{"name":"kashrut","in":"query","description":"Minimum kashrut for food places; places whose category involves no food are never filtered out","schema":{"type":"string","enum":["all","supervised","certified"],"default":"all"}},{"name":"q","in":"query","description":"Text contained in the name, accents ignored","schema":{"type":"string"}},{"$ref":"#/components/parameters/lang"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of places; `next` is the path of the following page or null","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlacesPage"}}}},"400":{"description":"Invalid parameter"},"404":{"description":"Unknown city"},"429":{"description":"Rate limited; see Retry-After"}}}}},"components":{"parameters":{"lang":{"name":"lang","in":"query","description":"Language of labels, descriptions and URLs","schema":{"type":"string","enum":["es-AR","es","en","fr","it"],"default":"en"}}},"schemas":{"PlacesPage":{"type":"object","properties":{"apiVersion":{"type":"string"},"attribution":{"type":"object"},"city":{"type":"object"},"total":{"type":"integer"},"offset":{"type":"integer"},"limit":{"type":"integer"},"next":{"type":["string","null"]},"places":{"type":"array","items":{"$ref":"#/components/schemas/Place"}}}},"Place":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","description":"Canonical page of the place; link to it when citing"},"category":{"type":"string","enum":["carniceria","restaurante","supermercado","almacen","hamburgueseria","panaderia","pizzeria","cafe","bar","heladeria","catering","vinoteca","sinagoga","beit_jabad","mikve","estudio","club","escuela","organizacion","museo","judaica","libreria","profesional","hotel","alquiler_temporario","tour","agencia_viajes"]},"categoryLabel":{"type":"string"},"kashrut":{"type":["object","null"],"description":"Null for places whose category involves no food","properties":{"level":{"type":"string","enum":["certified","supervised","self_declared","some_kosher_dishes","some_kosher_products","unconfirmed","kosher_style"]},"label":{"type":"string"},"certifiers":{"type":"array","items":{"type":"string"}},"kosherTypes":{"type":"array","items":{"type":"string","enum":["meat","dairy","pareve","mixed"]}},"glatt":{"type":"boolean"},"shomerShabbat":{"type":"boolean"}}},"address":{"type":["string","null"]},"neighborhood":{"type":["string","null"]},"city":{"type":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2"},"location":{"type":["object","null"],"properties":{"lat":{"type":"number"},"lng":{"type":"number"}}},"phone":{"type":["string","null"]},"website":{"type":["string","null"]},"description":{"type":["string","null"]},"communityRating":{"type":["object","null"],"description":"The guide's own reviews; never Google's","properties":{"average":{"type":"number"},"count":{"type":"integer"}}},"status":{"type":"string","enum":["operational","temporarily_closed","permanently_closed"]},"updatedAt":{"type":"string","format":"date-time"}}}}},"x-city-category-pages":"Each city category with 3 or more places has a page at /cities/<slug>/<category>."}