Bestanden downloaden

Krijg de actuele data. Het opsommen van beschikbare bestanden is openbaar; het downloaden van volledige exports, coördinaten of archieven verbruikt credits en vereist de juiste addon voor jouw organisatie.

Om de sleutel te verzenden, gebruik de X-API-Key header — zie Authenticatie. Kosten voor credits en snelheidslimieten staan in Snelheidslimieten & credits.

Lijst beschikbare bestanden (openbaar)

GET /v1/dataset/:table/files

Openbaar, kost geen credits. Retourneert de asset-URL's en de exportbestanden die beschikbaar zijn voor de dataset, zodat je weet welke formaten bestaan voordat je credits uitgeeft.

curl "https://api.topolab.nl/v1/dataset/nl-domino-poi/files"

{
  "table": "nl-domino-poi",
  "exports": [
    { "format": "csv",     "url": "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/csv",     "credits": 10 },
    { "format": "json",    "url": "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/json",    "credits": 10 },
    { "format": "geojson", "url": "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/geojson", "credits": 10 },
    { "format": "kml",     "url": "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/kml",     "credits": 10 },
    { "format": "shp",     "url": "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/shp",     "credits": 10 }
  ]
}

Download een volledige export

GET /v1/dataset/:table/files/:format

Vereist X-API-Key en de API_ACCESS addon. Kost 10 credits per download. Ondersteunde formaten: csv, json, geojson, kml, shp.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/nl-domino-poi/files/geojson" \
  -o nl-domino-poi.geojson

De endpoint streamt het bestand; gebruik -o om het op te slaan. GeoJSON en KML bevatten WGS84 (EPSG:4326) geometrie; CSV en JSON bevatten longitude/latitude kolommen in hetzelfde referentiesysteem. SHP wordt geleverd als een gecomprimeerd shapefile-pakket.

Alleen coördinaten

GET /v1/dataset/:table/coordinates

Vereist X-API-Key en de API_ACCESS addon. Kost 15 credits. Retourneert een JSON-array van WGS84 lng/lat paren — nuttig voor het plotten van punten op een kaart zonder elke attribuut op te halen.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/nl-domino-poi/coordinates"

[
  { "lng": 4.8952, "lat": 52.3702 },
  { "lng": 4.4777, "lat": 51.9244 },
  { "lng": 5.1214, "lat": 52.0907 }
]

Coördinaten zijn alleen WGS84 (EPSG:4326).

Historische archieven

Vervangingen uit het verleden worden bewaard als maandelijkse snapshots.

Lijst archiefmaanden (openbaar)

GET /v1/dataset/:table/archives/list

Openbaar, kost geen credits. Retourneert de maanden die beschikbaar zijn als snapshots.

curl "https://api.topolab.nl/v1/dataset/nl-domino-poi/archives/list"

{
  "table": "nl-domino-poi",
  "months": ["2026-05", "2026-04", "2026-03", "2026-02"]
}

Download een archiefmaand

GET /v1/dataset/:table/archives/:month/:format

Vereist X-API-Key en de ARCHIVED_DATA addon. Kost 20 credits. month is YYYY-MM; format is een van csv, json, geojson, kml, shp.

curl -H "X-API-Key: tlb_prod_..." \
  "https://api.topolab.nl/v1/dataset/nl-domino-poi/archives/2026-04/csv" \
  -o nl-domino-poi-2026-04.csv

Fouten

Status	Betekenis
401	Ontbrekende of ongeldige X-API-Key.
403	Sleutel is geldig maar mist de vereiste addon — API_ACCESS voor downloads en coördinaten, ARCHIVED_DATA voor archieven.
404	Onbekende table, niet-ondersteund format, of een archief month die niet beschikbaar is.
429	Snelheidslimiet overschreden — zie Snelheidslimieten & credits.

Heb je de addon nog niet? Neem contact met ons op om API_ACCESS of ARCHIVED_DATA in te schakelen.

Volgende

• Voorbeeldrijen — inspecteer het schema gratis voordat je downloadt.
• Vernieuwingshooks — detecteer wanneer een dataset is gewijzigd.
• Gebruikstatistieken — volg het verbruik van credits.