Dimos Athinaion

Search the datasets catalogued on opendata.cityofathens.gr — the City of Athens' own catalogue of 460+ datasets: daily WiFi visitor counts per Smart Neighbourhood station, parks and green space, GIS layers of the city, traffic and municipal services. 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": "πάρκα",
  "size": 5
}

Fetch one dataset from opendata.cityofathens.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": "wifi-highest-visitors-all-stations"
}

List the bodies that publish on opendata.cityofathens.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.

{
  "limit": 5
}

Find the tags datasets on opendata.cityofathens.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": "wifi",
  "limit": 10
}

How the catalogue on opendata.cityofathens.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": "theme"
}

Read rows from a resource opendata.cityofathens.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": "1cdccaf9-c11b-4393-b3c7-cf9d3f78ad0f",
  "filters": "{\"neighbourhood_name\":\"ΙΠΠΟΚΡΑΤΕΙΟ\"}",
  "sort": "date desc",
  "limit": 5
}

Fetch the file behind a resource on opendata.cityofathens.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": "e1c5f7de-feef-43af-bbec-f8247a47f2ee",
  "limit": 3
}