BYTETOOLS

dane.gov.pl API

Free Polish open data API with no key: thousands of government datasets covering statistics, health, transport and environment in JSON:API format. Tested.

No API key requiredHTTPSFree tier

Endpoint tested and returned HTTP 200 on 2026-08-20

What is the dane.gov.pl API?

dane.gov.pl is the free, key-free API for Poland's national open data portal, providing thousands of datasets published by Polish government institutions across statistics, health, transport, environment and public administration.

Poland's open data portal exposes a well-structured JSON:API interface, which is more modern than the CKAN portals many European countries run, though it means the JSON:API conventions apply.

Datasets and their downloadable resources are separate linked entities, so a typical workflow is to search datasets, then follow the relationship to fetch the actual files — the standard JSON:API pattern.

Quick facts

Base URL
https://api.dane.gov.pl/1.4
Authentication
No API key required for reading public datasets.
Rate limit
No published hard limit; fair use expected.
Pricing
Free open data.
CORS
Not enabled — call it from your server
Official docs
Read the docs

How to use the dane.gov.pl API

Every request below was executed against the live API on 2026-08-20, and the response shown is the real body it returned — not an illustration.

1. Search Polish government datasets

GET https://api.dane.gov.pl/1.4/datasets?per_page=1

curl
curl 'https://api.dane.gov.pl/1.4/datasets?per_page=1'
JavaScript (fetch)
const res = await fetch("https://api.dane.gov.pl/1.4/datasets?per_page=1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);
Python (requests)
import requests

res = requests.get("https://api.dane.gov.pl/1.4/datasets?per_page=1", timeout=20)
res.raise_for_status()
print(res.json())
Response — HTTP 200 (truncated)
{
  "links": {
    "next": "https://api.dane.gov.pl/1.4/datasets?per_page=1&sort=id&page=2",
    "self": "https://api.dane.gov.pl/1.4/datasets?per_page=1&sort=id&page=1",
    "last": "https://api.dane.gov.pl/1.4/datasets?per_page=1&sort=id&page=10000"
  },
  "jsonapi": {
    "version": "1.4"
  },
  "data": [
    {
      "type": "dataset",
      "links": {
        "self": "https://api.dane.gov.pl/1.4/datasets/1,dane-liczbowe-dot-kontroli-prowadzonych-przez-wiih-w-2014-r"
      },
      "id": "1",
      "relationships": {
        "showcases": {
          "meta": {
            "count": 0
          },
          "links": {
            "related": "https://api.dane.gov.pl/1.4/datasets/1,dane-liczbowe-dot-kontroli-prowadzonych-przez-wiih-w-2014-r/showcases"
          }
        },
        "resources": {
          "meta": {
            "count": 1
          },
          "links": {
            "related": "https://api.dane.gov.pl/1.4/datasets/1,dane-liczbowe-dot-kontroli-prowadzonych-przez-wiih-w-2014-r/resources"
          }
        },
        "institution": {
          "links": {
            "related": "https://api.dane.gov.pl/1.4/institutions/26,uokik"
          },
          "data": {
            "id": "26",
            "type": "institution"
          }
        }
      },
      "attributes": {
        "types": [
          "file"
        ],
        "has_high_value_data_from_ec_list": null,
        "has_dynamic_data": false,
        "license_chosen": null,
        "categories": [
          {
            "id": "148",
            "code": "GOVE",
            "title": "Rząd i sektor public

Parameters

ParameterTypeRequiredDescription
datasetspathOptionalDataset search and listing. datasets
per_pageintegerOptionalResults per page. 20
pageintegerOptionalPage number. 2
qstringOptionalSearch query. zdrowie
sortstringOptionalSort field. -created

Response fields

dataarray
JSON:API resource objects for each dataset.
data[].id / typestring
Resource identifier and type.
data[].attributes.titlestring
Dataset title, in Polish.
data[].attributes.notesstring
Dataset description.
data[].relationships.resourcesobject
Link to the downloadable files.
links.next / selfstring
Pagination links.
meta.countinteger
Total datasets matching.

What you can build with the dane.gov.pl API

  • Discover Polish government datasets programmatically
  • Automate ingestion of regularly updated Polish statistics
  • Build civic tech tools for Poland
  • Monitor an institution for new publications

Common errors and how to fix them

Attributes nested under data[].attributes

It follows JSON:API.

Fix: Read data[0].attributes.title rather than data[0].title.

Resources are a separate request

Files are linked, not embedded.

Fix: Follow the resources relationship link to get downloadable file URLs.

Polish-language metadata

Titles and descriptions are in Polish.

Fix: Expect this — there is no English translation layer.

dane.gov.pl API — frequently asked questions

Is dane.gov.pl free?

Yes, reading public datasets requires no API key.

Is the metadata in English?

No, titles and descriptions are in Polish, as you would expect from a Polish government portal.

Why is the data nested under attributes?

It implements the JSON:API specification, which wraps resource fields inside an attributes object with relationships linked separately.

How do I download an actual file?

Datasets link to resources rather than embedding them. Follow the resources relationship to get file URLs and formats.

Tools that pair with this API

JSON Formatter

Format, beautify and minify JSON online with 2-space, 4-space or tab indentation. Sort keys alphabetically and catch syntax errors instantly — free and private.

CSV to JSON Converter

Convert CSV to a JSON array of objects online. Header-row detection, comma/semicolon/tab delimiters and pretty-printed output — 100% in your browser.

dane.gov.pl is an independent third-party service and is not affiliated with ByteTools or ByteVancer. Details on this page were verified on 2026-08-20; always check the official documentation before relying on this API in production, as terms and limits can change.