Lijst datasets

Lijst de datasets in de catalogus. Dit eindpunt is openbaar, kost geen credits en is het toegangspunt voor ontdekking — vind hier de table van een dataset, en haal vervolgens de details, voorbeelden of bestanden op.

Eindpunt

GET /v1/dataset/all

Er is geen authenticatie vereist. Je kunt nog steeds een X-API-Key verzenden (bijvoorbeeld om één clientconfiguratie te behouden), maar het is niet nodig en er worden geen credits verbruikt.

Queryparameters

Parameter	Type	Beschrijving
page	integer	1-gebaseerd paginanummer. Standaard 1.
limit	integer	Items per pagina. Standaard 20, maximaal 100.
sortBy	string	Veld om op te sorteren, bijvoorbeeld title, totalRecords, modified.
sortOrder	string	asc of desc. Standaard asc.
search	string	Vrije tekstovereenkomst over titel, beschrijving en trefwoorden.
theme	string	Filter op thema, bijvoorbeeld Commerce. Zie ontdekkinghelpers.
country	string	ISO landcode, bijvoorbeeld nl.

Verzoek

curl "https://api.topolab.nl/v1/dataset/all?country=nl&theme=Commerce&sortBy=totalRecords&sortOrder=desc&page=1&limit=2"

Antwoord

Het antwoord is een gepagineerde envelop. Elk item bevat genoeg om een catalogusrij weer te geven en verder te linken via table.

{
  "data": [
    {
      "table": "nl-domino-poi",
      "title": "Domino's Pizza Locaties (NL)",
      "country": "nl",
      "totalRecords": 1234,
      "qualityGrade": { "grade": "A", "score": 0.93 },
      "metadata": {
        "theme": "Commerce",
        "accrualPeriodicity": "maandelijks",
        "modified": "2026-05-01",
        "keywords": ["retail", "punten van interesse", "voedselservice"]
      }
    },
    {
      "table": "nl-supermarkets-poi",
      "title": "Supermarkt Locaties (NL)",
      "country": "nl",
      "totalRecords": 6420,
      "qualityGrade": { "grade": "B", "score": 0.81 },
      "metadata": {
        "theme": "Commerce",
        "accrualPeriodicity": "maandelijks",
        "modified": "2026-04-18",
        "keywords": ["retail", "supermarkt", "punten van interesse"]
      }
    }
  ],
  "page": 1,
  "limit": 2,
  "total": 47
}

Veld	Beschrijving
data[]	Paginering van dataset samenvattingen.
data[].table	Stabiele identificator die in elk ander dataset eindpunt wordt gebruikt.
data[].title	Menselijk leesbare naam.
data[].country	ISO landcode.
data[].totalRecords	Aantal rijen in de dataset.
data[].qualityGrade	Letter grade (A–F) en numerieke score (0–1).
data[].metadata	Thema, frequentie, laatste wijzigingsdatum, trefwoorden en meer.
page, limit	Echo van het paginaverzoek.
total	Totaal aantal datasets dat overeenkomt met de filters.

Blader door de resultaten door page te verhogen totdat page * limit >= total.

Ontdekkinghelpers

Om filtercontroles in te vullen of een theme waarde te valideren voordat je een query uitvoert, gebruik deze openbare, zero-credit eindpunten:

curl "https://api.topolab.nl/v1/dataset/themes"
curl "https://api.topolab.nl/v1/dataset/industry-codes"

GET /v1/dataset/themes retourneert de verschillende thema's die in de catalogus aanwezig zijn. GET /v1/dataset/industry-codes retourneert de industrieclassificatiecodes waarmee datasets zijn gemarkeerd, voor code-gedreven filtering.

Fouten

Status	Betekenis
429	Rate limited — zie Rate limits & credits.

Dit eindpunt retourneert geen 401/403 omdat het openbaar is. Een niet-overeenkomend filter retourneert een lege data array met total: 0, niet 404.

Volgende

• Haal een dataset op — volledige details voor één table.
• Voorbeeldrijen — inspecteer schema en een deel van de rijen gratis.
• Heb je toegang nodig tot downloads? Neem contact met ons op voor de API_ACCESS add-on.