Redistributable. This source is served as canonical Parquet under the license below, with attribution and provenance preserved.

Coverage

Series catalogued

194

Temporal coverage

1924-12-31 – 2027-12-31

Licensing & provenance

License: gus-pl-open
License URL: https://stat.gov.pl/en/copyright/
Required attribution: Source: Statistics Poland (GUS), DBW. Licensed under CC BY 4.0.
Redistribution: Permitted (served here)
Commercial use: Yes
Modification: Permitted
Provider homepage: https://api-dbw.stat.gov.pl
Provider terms: https://api-dbw.stat.gov.pl

Access & mirrors

Download: Select & download gus_dbw series as CSV →
API: Get a free API key, then GET /v1/series/<id>.csv
Canonical landing: https://econdatalibrary.com/gus_dbw
Update cadence: monthly (target — not yet automated)
Automated refresh: not yet wired — the data here is the verified initial load. See the Source Status board.
Update strategy: extend by date
Storage layout: per-area parquet (area_{id}.parquet) merged from per-section part files under parts/area_{id}/v{var}_s{sec}.parquet; plus _cache/ (metadata JSON), _checkpoint.json, and logs/gus_dbw.DONE sentinel. area_15.parquet alone is ~109 MB. Schema: series_key (GUSDBW:var:sec:positions[:measure]), obs_date, value.

Full description

GUS Poland — DBW (Dziedzinowe Bazy Wiedzy) API, full crawl. License: Open data (GUS public data policy, CC BY 4.0) Source: https://api-dbw.stat.gov.pl/ (replaces the dead sdmx.stat.gov.pl) No API key required; optional registered key via env GUS_DBW_CLIENT_ID (sent as X-ClientId header). Endpoints (api/1.2.0): * /area/area-area?lang=en → flat tree of subject areas * /area/area-variable?id-obszaru={a}&lang=en → variables of an area * /variable/variable-meta?id-zmiennej={v}&lang=en → sections (przekroje) with frequency (id-czestotliwosc) and year range (szereg-czasowy) * /dictionaries/periods-dictionary?lang=en → id-okres → symbol (M01..M12, K1..K4, P1/P2, R...; id-okres=282 = annual) * /variable/variable-data-section?id-zmienna=&id-przekroj=&id-rok=&id-okres= &ile-na-stronie=5000&numer-strony=&lang=en → observations ("wartosc") RATE LIMITS (anonymous): 5 req/s, 100 req/15min, 1000 req/12h, 10000 req/7days. → 45 s minimum between requests (anonymous), 9 s with X-ClientId (registered tier: 10/s, 500/15min, 5000/12h, 50000/7d). This source takes WEEKS at anonymous rates — it is a long-haul crawler built around aggressive checkpointing: a JSON checkpoint of completed variable×section pairs, metadata cached on disk so restarts spend no budget, and one parquet part file per completed variable×section. When every variable of an area is done, parts merge into area_{id}.parquet. series_key: GUSDBW:{var_id}:{section_id}:{id-pozycja-* values}[:m{measure}] obs_date: annual → Dec 31; quarter → quarter start; month/half/week → start. Run: python jobs/ingest_gus_dbw.py

Structured metadata

schema.org/Dataset (Google Dataset Search)

{
  "@context": "https://schema.org/",
  "@type": "Dataset",
  "name": "Statistics Poland — Knowledge Databases / DBW API (Dziedzinowe Bazy Wiedzy)",
  "description": "Agricultural prices (Statistics Poland DBW area 10); Industry (Statistics Poland DBW area 100). 194 series, 1924–2027. Free download.",
  "url": "https://econdatalibrary.com/gus_dbw",
  "identifier": "gus_dbw",
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "includedInDataCatalog": {
    "@type": "DataCatalog",
    "@id": "https://econdatalibrary.com/#catalog",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com/catalog"
  },
  "creator": {
    "@type": "Organization",
    "name": "Statistics Poland",
    "url": "https://api-dbw.stat.gov.pl"
  },
  "license": "https://stat.gov.pl/en/copyright/",
  "keywords": [
    "Macroeconomics",
    "gus_dbw"
  ],
  "temporalCoverage": "1924-12-31/2027-12-31",
  "creditText": "Source: Statistics Poland (GUS), DBW. Licensed under CC BY 4.0.",
  "sameAs": [
    "https://huggingface.co/datasets/econdatalibrary-gus_dbw",
    "https://zenodo.org/communities/econdatalibrary"
  ],
  "distribution": [
    {
      "@type": "DataDownload",
      "name": "gus_dbw — CSV",
      "encodingFormat": "text/csv",
      "contentUrl": "https://econdatalibrary.com/download.html?source=gus_dbw",
      "license": "https://stat.gov.pl/en/copyright/"
    }
  ]
}

Croissant (ML-ready, schema.org JSON-LD)

{
  "@context": {
    "@language": "en",
    "@vocab": "https://schema.org/",
    "cr": "http://mlcommons.org/croissant/",
    "data": {
      "@id": "cr:data",
      "@type": "@json"
    },
    "dataType": {
      "@id": "cr:dataType",
      "@type": "@vocab"
    },
    "sc": "https://schema.org/",
    "conformsTo": "dct:conformsTo",
    "dct": "http://purl.org/dc/terms/"
  },
  "@type": "sc:Dataset",
  "conformsTo": "http://mlcommons.org/croissant/1.0",
  "name": "gus_dbw",
  "description": "Agricultural prices (Statistics Poland DBW area 10); Industry (Statistics Poland DBW area 100). 194 series, 1924–2027. Free download.",
  "url": "https://econdatalibrary.com/gus_dbw",
  "creator": {
    "@type": "sc:Organization",
    "name": "Statistics Poland",
    "url": "https://api-dbw.stat.gov.pl"
  },
  "publisher": {
    "@type": "sc:Organization",
    "name": "Econ Data Library",
    "url": "https://econdatalibrary.com"
  },
  "license": "https://stat.gov.pl/en/copyright/",
  "keywords": [
    "Macroeconomics"
  ],
  "temporalCoverage": "1924-12-31/2027-12-31",
  "distribution": [
    {
      "@type": "cr:FileObject",
      "@id": "gus_dbw-csv",
      "name": "gus_dbw-csv",
      "description": "Per-series CSV, downloadable with a free API key.",
      "contentUrl": "https://econdatalibrary.com/download.html?source=gus_dbw",
      "encodingFormat": "text/csv"
    }
  ]
}