data.gov.gr

Search the datasets catalogued on data.gov.gr — the national catalogue of 22,000+ datasets from ministries, regions, municipalities and agencies: geospatial layers, statistics, registers, budgets, measurements. Returns each dataset's slug, title, publishing body, licence, themes, formats and whether its rows can be queried here; get_dataset lists its files. `text` searches titles and descriptions (Solr: quote a phrase, AND/OR between words; a bare word matches anywhere). Filters combine with AND: `organization` takes the slug from list_organizations, `tag` an exact tag from list_tags, `format` a file format such as 'CSV' or 'GeoJSON', `licence` a licence id from list_facets, `theme` one of the EU data themes. Most datasets are geospatial layers (WMS, GeoJSON); `queryableOnly` keeps those whose rows are in the datastore and can be filtered with query_resource. A catalogue entry is a description of data, not the data: to read rows, pick a resource from get_dataset and use query_resource (datastore) or read_resource (the file).

{
  "text": "σχολεία",
  "format": "CSV",
  "size": 5
}

Fetch one dataset from data.gov.gr by its slug or id: the full description, publisher and contact, licence, tags, EU theme, update frequency, coverage, and every resource (file or service) it publishes — each with its format, size, URL, and whether it is `queryable` (loaded into the datastore, so query_resource can filter its rows) or only downloadable. This is the step between finding a dataset and reading it: pick the resource, then query_resource for a queryable one or read_resource for a CSV/JSON file.

{
  "dataset": "scholikes-monades-dimoy-naypaktias"
}

List the bodies that publish on data.gov.gr — ministries, regions, municipalities, agencies — with the slug `organization` on search_datasets takes and how many datasets each has, most first. `query` narrows by name (case and accents ignored). Bodies with no datasets are left out unless `includeEmpty` is set.

{
  "query": "δήμος",
  "limit": 10
}

Find the tags datasets on data.gov.gr carry, by part of the word — the exact spelling `tag` on search_datasets needs. Tags are free text from thousands of publishers, so the same idea appears in several spellings and cases; match the one you find.

{
  "query": "νερ",
  "limit": 10
}

How the catalogue on data.gov.gr divides up: the datasets under each licence, file format, EU data theme, update frequency, dataset type or high-value-dataset category, most first. The values are what search_datasets takes for `licence`, `format` and `theme`. Licences matter here: this catalogue carries many, some non-commercial, and each dataset's own applies.

{
  "facet": "licence"
}

Read rows from a resource data.gov.gr has loaded into its datastore — the ones get_dataset marks `queryable` — with filters, full-text search, sorting and paging done upstream. Returns the columns with their types, the matching row count and a page of records. `filters` is a JSON object of exact column matches, e.g. {"Demos": "ΑΘΗΝΑΙΩΝ"}; `text` matches any column; `sort` is 'column asc' or 'column desc'; `fields` picks columns. Column names are the publisher's, as the first call shows them. Not every resource is queryable — a resource that is not gets a not-found error; use read_resource on the file instead.

{
  "resourceId": "303d3452-7bf8-46f4-a506-0160fea2184b",
  "filters": "{\"Demos\":\"ΑΘΗΝΑΙΩΝ\"}",
  "limit": 5
}

Fetch the file behind a resource on data.gov.gr that is not in the datastore and read it here: a CSV (any delimiter, UTF-8 or Windows-1253) comes back as columns and rows, a JSON or GeoJSON file as its document with arrays paged. Files over 8 MB, spreadsheets, PDFs, map services and pages that turn out to be HTML are refused with the URL, which is what to hand the user then. Prefer query_resource where get_dataset marks the resource queryable — it filters upstream; this reads the whole file to show a slice.

{
  "resourceId": "303d3452-7bf8-46f4-a506-0160fea2184b",
  "limit": 5
}