Bouwgrondvinden Pipeline API

Hiermee stuur je de pipeline aan: aanbod scrapen, kavels verrijken, matches draaien. Elke request heeft de header X-API-Key nodig (de key staat in de .env op de server).

Technische referentie: /docs (Swagger — op de server met login)

Scraper

`POST /scrape/runs`	Aanbod ophalen, alleen JSON terug (schrijft niets)
`POST /store/runs`	Aanbod ophalen én in Airtable zetten (incl. dedup, wijzigingen, log)
`GET /vendors`	Lijst van de 17 bronnen

Runs (lange taken)

Scrape/store/match geven direct een run_id terug. Daarna:

`GET /runs`	Laatste runs
`GET /runs/{id}`	Status + resultaat (JSON)
`GET /runs/{id}/log`	Logregels van die run

Verrijken

`POST /enrich`	Eén adres → verrijkte kavel (±35 velden, incl. Kans-score, duurt ~30-60s)
`POST /enrich/batch`	Meerdere adressen tegelijk (run_id)

Optionele body-vlaggen (standaard false → geen betaalde calls): include_paid = ook Google reisafstand/-tijd; include_ai = ook de AI Kans-score-toelichting (OpenAI). De Kans-score-waarde wordt altijd gratis berekend. Deze vlaggen werken ook op /enrich/batch en /promote/runs.

Matchen

`POST /match/runs`	Alle zoekers x kavels scoren en in Matches zetten
`GET /match/preview`	Eén paar scoren, zonder te schrijven
`POST /match/scenario`	Wat als de zoeker flexibeler is? (criteria verruimen)

Promoveren

POST /promote/runs Gevalideerde review-rijen → verrijken → echte Kavels

Overig

`POST /faillissementen/runs`	Nieuwe faillissementen sinds een datum
`GET /export/kavels.geojson`	Kavels als GeoJSON (kaart/website)
`GET /alerts`	Alle huidige problemen in één lijst — n8n: als has_alerts, stuur alert
`GET /events`	Log-tail (filter op level/source)
`GET /health`	Werkt alles? (geen key nodig)
`GET /credits`	Firecrawl-tegoed

Voorbeeld

curl -X POST http://127.0.0.1:8300/enrich   -H "X-API-Key: JOUW_KEY" -H "Content-Type: application/json"   -d "{"address": "Industrieweg 7, Bladel"}"

Let op: /store/runs schrijft echt naar Airtable en /scrape/runs draait ~15 min over alle bronnen.