Krijg een dataset

Haal het volledige record op voor een enkele dataset, aangeduid met zijn table naam. Dit eindpunt is openbaar en kost geen credits. Gebruik het om een detailpagina van een dataset weer te geven of om te beslissen of je credits wilt besteden aan een download.

Eindpunt

GET /v1/dataset/:table

Pad- en queryparameters

Parameter	In	Beschrijving
table	pad	Dataset identificator, bijvoorbeeld nl-domino-poi.
locale	query	Taal voor gelokaliseerde tekstvelden: en (standaard) of nl.

Verzoek

curl "https://api.topolab.nl/v1/dataset/nl-domino-poi?locale=en"

Antwoord

{
  "table": "nl-domino-poi",
  "title": "Domino's Pizza Locaties (NL)",
  "description": "Elke Domino's Pizza winkel in Nederland met adres, geocode en winkelattributen, maandelijks vernieuwd.",
  "country": "nl",
  "totalRecords": 1234,
  "metadata": {
    "theme": "Commerce",
    "accrualPeriodicity": "maandelijks",
    "modified": "2026-05-01",
    "issued": "2024-09-12",
    "keywords": ["retail", "punten van interesse", "voedselservice"],
    "spatial": "Nederland",
    "license": "Topolab Commerciële Licentie v1"
  },
  "qualityGrade": { "grade": "A", "score": 0.93 },
  "fieldAnalysis": [
    { "field": "store_id",  "type": "string",  "nullRatio": 0.0,  "distinctCount": 1234 },
    { "field": "name",      "type": "string",  "nullRatio": 0.0,  "distinctCount": 1 },
    { "field": "city",      "type": "string",  "nullRatio": 0.0,  "distinctCount": 412 },
    { "field": "longitude", "type": "number",  "nullRatio": 0.01, "min": 3.36, "max": 7.22 },
    { "field": "latitude",  "type": "number",  "nullRatio": 0.01, "min": 50.75, "max": 53.55 }
  ],
  "sampleCsvUrl": "https://api.topolab.nl/v1/dataset/nl-domino-poi/sample/csv",
  "sampleJsonUrl": "https://api.topolab.nl/v1/dataset/nl-domino-poi/sample/json",
  "mapUrl": "https://api.topolab.nl/v1/dataset/nl-domino-poi/coordinates",
  "thumbnailUrl": "https://assets.topolab.nl/thumbnails/nl-domino-poi.png"
}

Veld	Beschrijving
table	Dataset identificator.
title	Gelokaliseerde naam (per locale).
description	Gelokaliseerde lange beschrijving (per locale).
country	ISO landcode.
totalRecords	Aantal rijen.
metadata.theme	Catalogus thema.
metadata.accrualPeriodicity	Vernieuwingsfrequentie, bijvoorbeeld maandelijks.
metadata.modified	Datum van de meest recente vernieuwing. Houd dit in de gaten om updates te detecteren — zie Vernieuwingshooks.
metadata.issued	Datum waarop de dataset voor het eerst is gepubliceerd.
metadata.keywords	Zoek-/classificatietags.
metadata.spatial	Geografische dekking.
metadata.license	Licentie waaronder de data wordt verstrekt.
qualityGrade	Letter grade (A–F) en numerieke score (0–1).
fieldAnalysis[]	Per-veld profiel: naam, type, null ratio, distinct count, en numerieke min/max waar van toepassing.
sampleCsvUrl, sampleJsonUrl	Directe links naar gratis monsters — zie Monster rijen.
mapUrl	Link naar het WGS84 coördinaten eindpunt (verbruikt credits wanneer opgehaald).
thumbnailUrl	Voorbeeldafbeelding.

Coördinaten zijn altijd WGS84 (EPSG:4326). Topolab levert geen geometrie in RD New (EPSG:28992).

Producten die deze dataset bevatten

Een dataset kan worden verkocht binnen een of meer commerciële producten. Om ze op te sommen:

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

Dit is openbaar en kost geen credits. Het retourneert de producten (prijs, licentie, slug) die de dataset bundelen, zodat je een ontwikkelaar naar een aankooppagina kunt linken. Sommige datasets zijn alleen B2B en hebben geen product; in dat geval is de array leeg.

Fouten

Status	Betekenis
404	Onbekende table.
429	Snelheidslimiet — zie Snelheidslimieten & credits.

Volgende

• Monster rijen — gratis schema en rijinspectie.
• Download bestanden — volledige exports en coördinaten (credits + API_ACCESS).
• Lijst datasets — vind andere tabellen.