{"openapi":"3.1.0","info":{"title":"De Nieuwe Gids API","description":"Onafhankelijke Nederlandse bedrijvengids. Bedrijven zijn gesorteerd op relevantie en wederzijdse validaties, niet op betaling. Ideaal voor AI agents die lokale/regionale bedrijven zoeken.","version":"1.1.0","contact":{"url":"https://www.denieuwegids.nl/"}},"servers":[{"url":"https://www.denieuwegids.nl","description":"Productie"}],"paths":{"/api/businesses.json":{"get":{"operationId":"listBusinesses","summary":"Bedrijven zoeken en doorbladeren","description":"Geeft actieve en geverifieerde bedrijven in de gids, inclusief branches, stad, type en validatiestatus. Filter server-side met q, branche, stad, type en status; blader met limit en offset. Gebruik has_more om te zien of er nog een pagina volgt; total is het aantal treffers over alle pagina's.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Zoekterm; matcht bedrijfsnaam, omschrijving, stad en branchenaam"},{"name":"branche","in":"query","required":false,"schema":{"type":"string"},"description":"Branche-slug, bijv. \"hovenier\". Zie /api/branches.json"},{"name":"stad","in":"query","required":false,"schema":{"type":"string"},"description":"Stad (gedeeltelijke match)"},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["local","regional","national","international","online"]},"description":"Bedrijfstype"},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","verified"]},"description":"Filter op verificatiestatus"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":200},"description":"Aantal resultaten per pagina"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"Sla de eerste N treffers over"}],"responses":{"200":{"description":"Lijst van bedrijven","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Aantal bedrijven in deze respons"},"total":{"type":"integer","description":"Aantal treffers over alle pagina's"},"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean","description":"True als er nog een pagina volgt"},"updated":{"type":"string","format":"date-time"},"businesses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"description":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"business_type":{"type":"string","enum":["local","regional","national","international","online"]},"status":{"type":"string","enum":["active","verified"]},"is_zzp":{"type":"boolean"},"founding_member":{"type":"boolean"},"validations_received":{"type":"integer"},"branches":{"type":"array","items":{"type":"string"}},"sbi":{"type":"array","description":"SBI-codes (Standaard Bedrijfsindeling) met hun officiële omschrijving. De eerste is de hoofdactiviteit.","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string","nullable":true}}}},"url":{"type":"string","format":"uri"},"social":{"type":"object","properties":{"linkedin":{"type":"string","nullable":true},"facebook":{"type":"string","nullable":true},"instagram":{"type":"string","nullable":true},"x":{"type":"string","nullable":true},"youtube":{"type":"string","nullable":true}}}}}}}}}}}}}},"/api/zoeken":{"get":{"operationId":"searchBusinesses","summary":"Zoek bedrijven en branches","description":"Zoek op naam, branche of stad. Minimaal 2 tekens vereist. Geeft suggesties voor bedrijven én branches.","parameters":[{"name":"q","in":"query","required":true,"description":"Zoekterm (minimaal 2 tekens)","schema":{"type":"string","minLength":2}},{"name":"limit","in":"query","required":false,"description":"Aantal bedrijfssuggesties (1-50, standaard 6)","schema":{"type":"integer","minimum":1,"maximum":50,"default":6}}],"responses":{"200":{"description":"Zoekresultaten","content":{"application/json":{"schema":{"type":"object","properties":{"businesses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"city":{"type":"string"},"slug":{"type":"string"}}}},"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"count":{"type":"integer"}}}}}}}}}}}},"/api/branches.json":{"get":{"operationId":"listBranches","summary":"Alle branches met bedrijfsaantal","description":"Geeft elke branche die minstens één bedrijf bevat, met slug en aantal. De slug is de waarde voor de branche-parameter van /api/businesses.json.","responses":{"200":{"description":"Lijst van branches","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"updated":{"type":"string","format":"date-time"},"branches":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"count":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}}}}}}}}},"/api/cities.json":{"get":{"operationId":"listCities","summary":"Alle steden met bedrijfsaantal","description":"Geeft elke stad waarin minstens één bedrijf staat, met slug en aantal.","responses":{"200":{"description":"Lijst van steden","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"updated":{"type":"string","format":"date-time"},"cities":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"count":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}}}}}}}}}}}