Dane i API

Eksport CSV i endpointy JSON — dokumentacja techniczna

Dane epidemiologiczne na EpiData.pl pochodzą z oficjalnych źródeł instytucjonalnych (NIZP-PZH, WHO GHO, Eurostat). Przy korzystaniu z API prosimy o rozsądne użytkowanie — nie scraperuj całej bazy w pętli.

Eksport CSV

Na każdej stronie choroby (np. /choroby/influenza) dostępny jest przycisk „Pobierz CSV” eksportujący dane w formacie CSV z kolumnami: year, date, disease_id, source_id, region_id, cases, incidence_per_100k, deaths

Dane zgodne z oficjalnymi raportami NIZP-PZH — zachowaj atrybucję źródła przy publikacji.

Endpointy JSON

GET

/api/data-points

Punkty danych epidemiologicznych. Zwraca szeregi czasowe z liczbą przypadków i zapadalnością.

Parametry zapytania

diseaseIdstringID choroby, np. INFLUENZA, TUBERCULOSIS, SALMONELLA

sourceIdstringID źródła: nizp-pzh, who-gho, eurostat

regionIdstringID regionu, np. PL (domyślnie wszystkie)

yearFromnumberRok od (min. 1970, dane WHO GHO od 1974)

yearTonumberRok do (max. 2100)

limitnumberLiczba wyników na stronę (1–1000, domyślnie 100)

pagenumberNumer strony (domyślnie 1)

Przykład

https://epidata.pl/api/data-points?diseaseId=INFLUENZA&sourceId=nizp-pzh&yearFrom=2020

Odpowiedź

{
  "data": [
    {
      "id": 42,
      "diseaseId": "INFLUENZA",
      "regionId": "PL",
      "sourceId": "nizp-pzh",
      "date": "2024-12-31",
      "year": 2024,
      "week": null,
      "cases": 5886,
      "incidencePer100k": "15.67",
      "deaths": null
    }
  ],
  "meta": { "total": 1, "page": 1, "limit": 100 }
}

GET

/api/diseases

Lista wszystkich monitorowanych chorób z nazwami polskimi i angielskimi oraz kodami ICD-10.

Przykład

https://epidata.pl/api/diseases

Odpowiedź

{
  "data": [
    {
      "id": "INFLUENZA",
      "nameEn": "Influenza",
      "namePl": "Grypa (potwierdzone)",
      "icd10Code": "J10",
      "category": "infectious",
      "description": null
    }
  ],
  "meta": { "total": 19, "page": 1, "limit": 19 }
}

GET

/api/sources

Lista źródeł danych z informacjami o licencji i dacie ostatniej aktualizacji.

Przykład

https://epidata.pl/api/sources

Odpowiedź

{
  "data": [
    {
      "id": "nizp-pzh",
      "name": "Narodowy Instytut Zdrowia Publicznego — PZH",
      "shortName": "NIZP-PZH",
      "url": "https://wwwold.pzh.gov.pl/oldpage/epimeld/",
      "license": "CC BY 4.0"
    }
  ],
  "meta": { "total": 3, "page": 1, "limit": 3 }
}

Identyfikatory chorób (diseaseId)

SALMONELLASALMONELLA-FOODSALMONELLA-SEPSALMONELLA-OTHERINFLUENZAINFLUENZA-CHILDCOVID19COVID19-POSSIBLEMEASLESTUBERCULOSISPERTUSSISMENINGOCOCCALMENINGOCOCCAL-MENMENINGOCOCCAL-SEPHEPATITIS-AHEPATITIS-BHEPATITIS-B-ACUTEHEPATITIS-CHEPATITIS-C-ACUTE

Pełna lista z nazwami polskimi i kodami ICD-10 dostępna pod /api/diseases

Licencja i atrybucja

Dane epidemiologiczne pochodzą z publicznych raportów NIZP-PZH (Narodowy Instytut Zdrowia Publicznego — Państwowy Zakład Higieny), WHO GHO i Eurostat.

Przy publikacji zachowaj atrybucję: „Dane: NIZP-PZH za pośrednictwem EpiData.pl” lub „Źródło: NIZP-PZH / epidata.pl”.

Skontaktuj się przez bynexo.pl jeśli potrzebujesz danych w innym formacie lub masz pytania o metodologię.