# CDC — Zapi reference > US CDC open data — Socrata dataset catalogue and SoQL queries, syndicated public-health content, environmental health tracking and WONDER mortality queries. **Base URL:** `https://api.zpi.web.id` **Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys. **Response envelope:** `{ content, message, errors }` **Rate limit:** 60 req/min on free tier. **Related:** - Detail page: https://zpi.web.id/api/health/cdc - Endpoint catalog: https://zpi.web.id/category/health - Concise index: https://zpi.web.id/llms.txt - Full reference: https://zpi.web.id/llms-full.txt --- ## CDC **Category:** health · **Slug:** `cdc` **Detail page:** https://zpi.web.id/api/health/cdc US CDC open data — Socrata dataset catalogue and SoQL queries, syndicated public-health content, environmental health tracking and WONDER mortality queries. **Tags:** cdc, public-health, open-data, socrata, wonder, surveillance ### Content Media Types CDC syndication media-type vocabulary — the names content-search's mediaType accepts. One-shot: the upstream returns the whole list in one response, so no page envelope. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/content-media-types` - **Cache TTL:** 300s **Parameters:** _No parameters._ **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/content-media-types" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/content-media-types", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/content-media-types", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 14, "items": [ { "name": "Badge", "mediaCount": 20, "description": "Badges", "displayOrder": 10 }, { "name": "Button", "mediaCount": 441, "description": "Buttons", "displayOrder": 20 }, { "name": "Feed", "mediaCount": 42, "description": "Managed Feed", "displayOrder": 50 }, { "name": "Feed - Import", "mediaCount": 10, "description": "Import Feed", "displayOrder": 60 }, { "name": "Feed - Aggregate", "mediaCount": 4, "description": "Aggregate Feed", "displayOrder": 75 }, { "name": "HTML", "mediaCount": 3884, "description": "HTML Content", "displayOrder": 80 }, { "name": "Image", "mediaCount": 32, "description": "Images", "displayOrder": 90 }, { "name": "Infographic", "mediaCount": 170, "description": "Infographics", "displayOrder": 100 } ], "provider": "cdc" } ``` --- ### Content Search CDC syndicated content (Public Health Media Library). `attribution` and `syndicateUrl` are what make an item legally reusable, so the mapper keeps every one of the 60 upstream fields rather than a summary subset. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/content-search` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `name` | string | query | no | Exact item title. The upstream matches the whole title, not a substring | | `mediaType` | string | query | no | Comma-separated media type names from the content-media-types endpoint | | `topicId` | string | query | no | Comma-separated topic ids from the content-topics endpoint | | `language` | string | query | no | Language display name such as English or Spanish | | `sort` | enum(newest|oldest|recentlyUpdated|leastRecentlyUpdated) | query | no | Sort order. Default newest by publication date | | `page` | number | query | no | Page number. Default 1 | | `limit` | number | query | no | Items per page. Default 20, max 100 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/content-search?name=Asthma&mediaType=HTML%2CVideo&topicId=5288&language=Spanish&sort=newest&page=1&limit=20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/content-search?name=Asthma&mediaType=HTML%2CVideo&topicId=5288&language=Spanish&sort=newest&page=1&limit=20", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/content-search?name=Asthma&mediaType=HTML%2CVideo&topicId=5288&language=Spanish&sort=newest&page=1&limit=20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "page": 1, "count": 0, "items": [], "limit": 3, "total": 0, "hasMore": false, "nextPage": null, "provider": "cdc", "totalPages": 0 } ``` --- ### Content Topics CDC syndication topic vocabulary — the ids that content-search's topicId accepts. Topics nest one level deep, so each row carries its sub-topics as `children`. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/content-topics` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `page` | number | query | no | Page number. Default 1 | | `limit` | number | query | no | Topics per page. Default 20, max 100 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/content-topics?page=1&limit=20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/content-topics?page=1&limit=20", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/content-topics?page=1&limit=20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "page": 1, "count": 3, "items": [ { "name": "Data & Statistics", "topicId": 5495, "children": [ { "name": "Abortion Surveillance", "topicId": 5224, "language": "English", "childCount": 0, "mediaCount": 3, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Active Bacterial Core surveillance (ABCs)", "topicId": 5229, "language": "English", "childCount": 0, "mediaCount": 2, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Alcohol", "topicId": 5250, "language": "English", "childCount": 0, "mediaCount": 32, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Alcohol Outlet Density", "topicId": 5251, "language": "English", "childCount": 0, "mediaCount": 0, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Behavioral Risk Factor Surveillance System (BRFSS)", "topicId": 5304, "language": "English", "childCount": 0, "mediaCount": 0, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Birth Defects", "topicId": 5314, "children": [ { "name": "Microcephaly", "topicId": 10784, "language": "English", "childCount": 0, "mediaCount": 2, "description": "Microcephaly", "displayOrder": 0 } ], "language": "English", "childCount": 1, "mediaCount": 47, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "BRFSS (Behavioral Risk Factor Surveillance System)", "topicId": 5343, "language": "English", "childCount": 0, "mediaCount": 1, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Cancer Clusters", "topicId": 5359, "language": "English", "childCount": 0, "mediaCount": 1, "description": "Sourced data from 2.6", "displayOrder": 0 } ], "language": "English", "childCount": 73, "mediaCount": 707, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Diseases & Conditions", "topicId": 5528, "children": [ { "name": "Acanthamoeba Infection", "topicId": 5225, "language": "English", "childCount": 0, "mediaCount": 0, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Acinetobacter Infection", "topicId": 5228, "language": "English", "childCount": 0, "mediaCount": 1, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Adenovirus Infection", "topicId": 5233, "language": "English", "childCount": 0, "mediaCount": 3, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "ADHD (Attention Deficit/Hyperactivity Disorder)", "topicId": 5234, "language": "English", "childCount": 0, "mediaCount": 4, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Allergies", "topicId": 5253, "language": "English", "childCount": 0, "mediaCount": 2, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "ALS (Amyotrophic Lateral Sclerosis)", "topicId": 5254, "language": "English", "childCount": 0, "mediaCount": 9, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Alzheimer's Disease", "topicId": 5255, "language": "English", "childCount": 0, "mediaCount": 12, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Amebiasis, Intestinal (Entamoeba histolytica infection)", "topicId": 5256, "language": "English", "childCount": 0, "mediaCount": 1, "description": "Sourced data from 2.6", "displayOrder": 0 } ], "language": "English", "childCount": 510, "mediaCount": 6922, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Emergency Preparedness", "topicId": 5565, "children": [ { "name": "Acute-Care Hospitals", "topicId": 5232, "language": "English", "childCount": 0, "mediaCount": 1, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Advanced Molecular Detection", "topicId": 5238, "language": "English", "childCount": 0, "mediaCount": 4, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Anthrax", "topicId": 5270, "language": "English", "childCount": 0, "mediaCount": 15, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Bacterial Special Pathogens Branch (BSPB)", "topicId": 5296, "language": "English", "childCount": 0, "mediaCount": 1, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Bioterrorism", "topicId": 5310, "language": "English", "childCount": 0, "mediaCount": 2, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Bioterrorism Agents/Diseases", "topicId": 5311, "language": "English", "childCount": 0, "mediaCount": 2, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Blood Safety", "topicId": 5323, "language": "English", "childCount": 0, "mediaCount": 3, "description": "Sourced data from 2.6", "displayOrder": 0 }, { "name": "Blood supply safety", "topicId": 5324, "language": "English", "childCount": 0, "mediaCount": 2, "description": "Sourced data from 2.6", "displayOrder": 0 } ], "language": "English", "childCount": 64, "mediaCount": 787, "description": "Sourced data from 2.6", "displayOrder": 0 } ], "limit": 3, "total": 13, "hasMore": true, "nextPage": 2, "provider": "cdc", "totalPages": 5 } ``` --- ### Content One CDC syndicated media item, with all 60 upstream fields kept. A retired or unknown id answers HTTP 200 with an empty result set rather than a 404, so emptiness is the not-found signal here. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/content/:mediaId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `mediaId` | number | path | yes | Media item id, as returned by the content-search endpoint | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/content/:mediaId" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/content/:mediaId", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/content/:mediaId", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "name": "Respiratory Infections and Asthma", "tags": [ { "id": 5288, "name": "Asthma", "type": "Topic", "language": "English" } ], "apiUrl": "https://tools.cdc.gov/api/v2/resources/media/405289.json", "author": "lza2", "source": { "name": "Centers for Disease Control and Prevention", "acronym": "CDC" }, "status": "Published", "mediaId": 405289, "embedUrl": "https://tools.cdc.gov/api/v2/resources/media/405289/embed.json", "language": { "name": "English", "isoCode": "eng", "isoCode2": "en" }, "provider": "cdc", "embedCode": "
", "mediaType": "HTML", "pageCount": 0, "sourceUrl": "https://www.cdc.gov/asthma/respiratory-infections/index.html", "targetUrl": "https://www.cdc.gov/asthma/respiratory-infections/index.html", "updatedAt": "2026-08-28T21:10:24Z", "childCount": 0, "contentUrl": "https://tools.cdc.gov/api/v2/resources/media/405289/content.html", "attribution": "
Content provided and maintained by the US Centers for Disease Control and Prevention (CDC). Please see our system usage guidelines and disclaimer.
", "description": "Information on flu, COVID, RSV and other respiratory infections and relation to asthma", "owningOrgId": "HCUG", "parentCount": 0, "publishedAt": "2026-08-28T04:00:00Z", "syndicateUrl": "https://tools.cdc.gov/api/v2/resources/media/405289/syndicate.json", "thumbnailUrl": "https://tools.cdc.gov/api/v2/resources/media/405289/thumbnail.png", "owningOrgName": "NATIONAL CENTER FOR ENVIRONMENTAL HEALTH", "persistentUrl": "https://tools.cdc.gov/api/v2/resources/purls/XXMPR", "alternateImages": [ { "id": 1347454, "url": "https://tools.cdc.gov/api/v2/resources/links/1347454.png", "name": "thumbnail", "type": "Thumbnail", "width": 155, "height": 84 }, { "id": 1352891, "url": "https://tools.cdc.gov/api/v2/resources/links/1352891.png", "name": "200x200", "type": "Sized Preview", "width": 200, "height": 200 }, { "id": 1358324, "url": "https://tools.cdc.gov/api/v2/resources/links/1358324.png", "name": "300x300", "type": "Sized Preview", "width": 300, "height": 300 } ], "isTopSyndicated": false, "contentUpdatedAt": "2026-08-28T04:00:00Z", "maintainingOrgId": "HCUG", "contentAuthoredAt": "2020-03-17T19:26:21Z", "contentReviewedAt": "2026-08-28T04:00:00Z", "maintainingOrgName": "NATIONAL CENTER FOR ENVIRONMENTAL HEALTH", "persistentUrlToken": "XXMPR", "syndicationUpdatedAt": "2026-08-28T21:10:24Z", "syndicationVisibleAt": "2026-08-28T04:00:00Z", "syndicationCapturedAt": "2020-03-18T17:18:49Z" } ``` --- ### Dataset Count Row count for a CDC Socrata dataset, optionally under a SoQL filter. One-shot: the upstream has no page concept here, so no page/limit envelope. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/dataset-count/:datasetId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `datasetId` | string | path | yes | Socrata four-by-four dataset id. CDC retires ids, so resolve a current one through the datasets endpoint | | `where` | string | query | no | SoQL $where filter. Omit to count every row in the dataset | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/dataset-count/:datasetId?where=year%3D'2024'" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/dataset-count/:datasetId?where=year%3D'2024'", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/dataset-count/:datasetId?where=year%3D'2024'", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "total": 425880, "where": "year='2024'", "provider": "cdc", "datasetId": "x9gk-5huc" } ``` --- ### Dataset Rows Rows from any CDC Socrata dataset via SoQL. The row shape is defined by the dataset's own column schema — NNDSS returns 11 fields, BRFSS 27 — so nothing here assumes a field name. Keys are camelCased and - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/dataset-rows/:datasetId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `datasetId` | string | path | yes | Socrata four-by-four dataset id. CDC retires ids, so resolve a current one through the datasets endpoint | | `select` | string | query | no | SoQL $select. Supports count(), sum(), avg(), min(), max(), date_trunc_y, date_trunc_ym, date_trunc_ymd | | `where` | string | query | no | SoQL $where filter. Also supports within_circle() | | `group` | string | query | no | SoQL $group — column list to aggregate by | | `having` | string | query | no | SoQL $having filter on aggregated rows | | `order` | string | query | no | SoQL $order. Use it whenever paging deeply | | `query` | string | query | no | Full-text search across the whole row ($q) | | `excludeSystemFields` | enum(true|false) | query | no | Drop Socrata's :computed_region and :id columns. Default false | | `page` | number | query | no | Page number. Default 1 | | `limit` | number | query | no | Rows per page. Default 100, max 1000 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/dataset-rows/:datasetId?select=states%2Cyear%2Cweek%2Clabel%2Cm1&where=year%3D'2024'%20AND%20label%3D'Anthrax'&group=label&having=sum(m1)%20%3E%20100&order=sort_order%20ASC&query=anthrax&excludeSystemFields=true&page=1&limit=100" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/dataset-rows/:datasetId?select=states%2Cyear%2Cweek%2Clabel%2Cm1&where=year%3D'2024'%20AND%20label%3D'Anthrax'&group=label&having=sum(m1)%20%3E%20100&order=sort_order%20ASC&query=anthrax&excludeSystemFields=true&page=1&limit=100", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/dataset-rows/:datasetId?select=states%2Cyear%2Cweek%2Clabel%2Cm1&where=year%3D'2024'%20AND%20label%3D'Anthrax'&group=label&having=sum(m1)%20%3E%20100&order=sort_order%20ASC&query=anthrax&excludeSystemFields=true&page=1&limit=100", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "page": 1, "count": 100, "items": [ { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "US RESIDENTS", "location2": "US RESIDENTS", "sortOrder": "20220100001" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "NEW ENGLAND", "location2": "NEW ENGLAND", "sortOrder": "20220100002" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "CONNECTICUT", "geocode": { "type": "Point", "coordinates": [ -72.738288, 41.575155 ] }, "location1": "CONNECTICUT", "sortOrder": "20220100003", "computedRegionHjspUmg2": "24", "computedRegionSkr5Azej": "1043" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "MAINE", "geocode": { "type": "Point", "coordinates": [ -69.06137, 45.117911 ] }, "location1": "MAINE", "sortOrder": "20220100004", "computedRegionHjspUmg2": "49", "computedRegionSkr5Azej": "1725" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "MASSACHUSETTS", "geocode": { "type": "Point", "coordinates": [ -71.481104, 42.151077 ] }, "location1": "MASSACHUSETTS", "sortOrder": "20220100005", "computedRegionHjspUmg2": "25", "computedRegionSkr5Azej": "1916" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "NEW HAMPSHIRE", "geocode": { "type": "Point", "coordinates": [ -71.57139, 43.680429 ] }, "location1": "NEW HAMPSHIRE", "sortOrder": "20220100006", "computedRegionHjspUmg2": "26", "computedRegionSkr5Azej": "2405" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "RHODE ISLAND", "geocode": { "type": "Point", "coordinates": [ -71.534637, 41.572574 ] }, "location1": "RHODE ISLAND", "sortOrder": "20220100007", "computedRegionHjspUmg2": "27", "computedRegionSkr5Azej": "2703" }, { "m2": "0", "week": "1", "year": "2022", "label": "Anthrax", "m1Flag": "-", "m2Flag": "-", "m3Flag": "-", "m4Flag": "-", "states": "VERMONT", "geocode": { "type": "Point", "coordinates": [ -72.662695, 44.075252 ] }, "location1": "VERMONT", "sortOrder": "20220100008", "computedRegionHjspUmg2": "28", "computedRegionSkr5Azej": "905" } ], "limit": 100, "total": null, "fields": [ "states", "year", "week", "label", "m1Flag", "m2", "m2Flag", "m3Flag" ], "hasMore": true, "nextPage": 2, "provider": "cdc", "datasetId": "x9gk-5huc" } ``` --- ### Dataset One CDC dataset's metadata and column schema (Socrata views API). Socrata row shape is per-dataset, so this is the schema source that dataset-rows deliberately does not guess at. - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/dataset/:datasetId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `datasetId` | string | path | yes | Socrata four-by-four dataset id. CDC retires ids, so resolve a current one through the datasets endpoint | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/dataset/:datasetId" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/dataset/:datasetId", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/dataset/:datasetId", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "name": "NNDSS Weekly Data", "tags": [ "nndss", "2022", "wonder", "2023", "2024", "2025" ], "owner": { "id": "jy77-2p5t", "name": "Nicole Pham", "type": "interactive", "screenName": "Nicole Pham" }, "author": { "id": "jy77-2p5t", "name": "Nicole Pham", "type": "interactive", "screenName": "Nicole Pham" }, "locked": false, "rights": [ "read" ], "columns": [ { "id": 554475832, "name": "Reporting Area", "stats": { "count": 1958040, "largest": "WYOMING", "nonNull": 1958040, "smallest": "Alabama", "nullCount": 0, "topValues": [ { "count": 17705, "value": "GUAM" }, { "count": 17705, "value": "INDIANA" }, { "count": 17705, "value": "EAST SOUTH CENTRAL" }, { "count": 17705, "value": "GEORGIA" }, { "count": 17705, "value": "HAWAII" }, { "count": 17705, "value": "ILLINOIS" }, { "count": 17705, "value": "DISTRICT OF COLUMBIA" }, { "count": 17705, "value": "EAST NORTH CENTRAL" } ], "cardinality": 1958040 }, "dataType": "text", "position": 1, "fieldName": "states", "renderType": "text" }, { "id": 554475833, "name": "Current MMWR Year", "stats": { "count": 1958040, "largest": "2026", "nonNull": 1958040, "smallest": "2022", "nullCount": 0, "topValues": [ { "count": 441490, "value": "2025" }, { "count": 425880, "value": "2024" }, { "count": 413070, "value": "2023" }, { "count": 400400, "value": "2022" }, { "count": 277200, "value": "2026" } ], "cardinality": 1958040 }, "dataType": "text", "position": 2, "fieldName": "year", "renderType": "text" }, { "id": 554475834, "name": "MMWR WEEK", "stats": { "count": 1958040, "largest": "53", "nonNull": 1958040, "smallest": "1", "nullCount": 0, "topValues": [ { "count": 40530, "value": "2" }, { "count": 40530, "value": "3" }, { "count": 40530, "value": "4" }, { "count": 40530, "value": "5" }, { "count": 40530, "value": "6" }, { "count": 40530, "value": "7" }, { "count": 40530, "value": "8" }, { "count": 40530, "value": "9" } ], "cardinality": 1958040 }, "dataType": "number", "position": 3, "fieldName": "week", "renderType": "number" }, { "id": 554475836, "name": "Label", "stats": { "count": 1958040, "largest": "Zika virus disease, non-congenital", "nonNull": 1958040, "smallest": "Anthrax", "nullCount": 0, "topValues": [ { "count": 16940, "value": "Cryptosporidiosis" }, { "count": 16940, "value": "Arboviral diseases, Eastern equine encephalitis virus disease" }, { "count": 16940, "value": "Cholera" }, { "count": 16940, "value": "Arboviral diseases, Chikungunya virus disease" }, { "count": 16940, "value": "Arboviral diseases, Powassan virus disease" }, { "count": 16940, "value": "Arboviral diseases, St. Louis encephalitis virus disease" }, { "count": 16940, "value": "Arboviral diseases, Jamestown Canyon virus disease" }, { "count": 16940, "value": "Chlamydia trachomatis infection" } ], "cardinality": 1958040 }, "dataType": "text", "position": 5, "fieldName": "label", "renderType": "text" }, { "id": 554475853, "name": "Current week", "stats": { "count": 1958040, "largest": "18198", "nonNull": 203193, "smallest": "1.0", "nullCount": 1754847, "topValues": [ { "count": 54812, "value": "1" }, { "count": 23154, "value": "2" }, { "count": 14189, "value": "3" }, { "count": 9900, "value": "4" }, { "count": 7377, "value": "5" }, { "count": 5920, "value": "6" }, { "count": 4961, "value": "7" }, { "count": 4079, "value": "8" } ], "cardinality": 1958040 }, "dataType": "number", "position": 6, "fieldName": "m1", "renderType": "number" }, { "id": 554475838, "name": "Current week, flag", "stats": { "count": 1958040, "largest": "U", "nonNull": 1877768, "smallest": "-", "nullCount": 80272, "topValues": [ { "count": 1798982, "value": "-" }, { "count": 71474, "value": "N" }, { "count": 7312, "value": "U" } ], "cardinality": 1958040 }, "dataType": "text", "position": 7, "fieldName": "m1_flag", "renderType": "text" }, { "id": 554475839, "name": "Previous 52 week Max", "stats": { "count": 1958040, "largest": "37668", "nonNull": 1745678, "smallest": "0.0", "nullCount": 212362, "topValues": [ { "count": 907857, "value": "0" }, { "count": 292049, "value": "1" }, { "count": 122266, "value": "2" }, { "count": 65543, "value": "3" }, { "count": 43737, "value": "4" }, { "count": 29055, "value": "5" }, { "count": 21538, "value": "6" }, { "count": 18219, "value": "7" } ], "cardinality": 1958040 }, "dataType": "number", "position": 8, "fieldName": "m2", "renderType": "number" }, { "id": 554475840, "name": "Previous 52 weeks Max, flag", "stats": { "count": 1958040, "largest": "NC", "nonNull": 1310748, "smallest": "-", "nullCount": 647292, "topValues": [ { "count": 1098386, "value": "-" }, { "count": 212362, "value": "NC" } ], "cardinality": 1958040 }, "dataType": "text", "position": 9, "fieldName": "m2_flag", "renderType": "text" } ], "rowsUrl": "https://data.cdc.gov/resource/x9gk-5huc.json", "category": "NNDSS", "isPublic": true, "provider": "cdc", "viewType": "tabular", "assetType": "dataset", "createdAt": "2021-07-20T14:27:50.000Z", "datasetId": "x9gk-5huc", "permalink": "https://data.cdc.gov/d/x9gk-5huc", "viewCount": 124337, "provenance": "official", "attribution": "Office of Public Health Data, Surveillance, and Technology, Centers for Disease Control and Prevention", "columnCount": 18, "description": "NNDSS - In this Table, provisional cases* of notifiable diseases are displayed for United States, U.S. territories, and Non-U.S. residents.\n\n\nNotes:\n• These are weekly cases of selected infectious national notifiable diseases, from the National Notifiable Diseases Surveillance System (NNDSS). NNDSS data reported by the 50 states, New York City, the District of Columbia, and the U.S. territories are collated and published weekly as numbered tables available at https://www.cdc.gov/nndss/infectious-disease/index.html. Cases reported by state health departments to CDC for weekly publication are subject to ongoing revision of information and delayed reporting. Therefore, numbers listed in later weeks may reflect changes made to these counts as additional information becomes available. Case counts in the tables are presented as published each week. See also Guide to Interpreting Provisional and Finalized NNDSS Data.\n\n• Notices, errata, and other notes are available in the Notice To Data Users page https://www.cdc.gov/nndss/infectious-disease/notice-to-data-users.html.\n\n• The list of national notifiable infectious diseases and conditions and their national surveillance case definitions are available at https://ndc.services.cdc.gov/. This list incorporates the Council of State and Territorial Epidemiologists (CSTE) position statements approved by CSTE for national surveillance.\n\nFootnotes:\n*Case counts for reporting years 2024 and 2025 are provisional and subject to change. Cases are assigned to the reporting jurisdiction submitting the case to NNDSS, if the case's country of usual residence is the U.S., a U.S. territory, unknown, or null (i.e. country not reported); otherwise, the case is assigned to the 'Non-U.S. Residents' category. Country of usual residence is currently not reported by all jurisdictions or for all conditions. For further information on interpretation of these data, see https://www.cdc.gov/nndss/docs/Readers-Guide-WONDER-Tables-20210421-508.pdf.\n†Previous 52 week maximum and cumulative YTD are determined from periods of time when the condition was reportable in the jurisdiction (i.e., may be less than 52 weeks of data or incomplete YTD data).\n• Please refer to the Stacks publication for weekly updates to the footnote for influenza-associated pediatric mortality.\nU: Unavailable — The reporting jurisdiction was unable to send the data to CDC or CDC was unable to process the data.\n-: No reported cases — The reporting jurisdiction did not submit any cases to CDC.\nN: Not reportable — The disease or condition was not reportable by law, statute, or regulation in the reporting jurisdiction.\nNN: Not nationally notifiable — This condition was not designated as being nationally notifiable.\nNP: Nationally notifiable but not published.\nNC: Not calculated — There is insufficient data available to support the calculation of this statistic.\nCum: Cumulative year-to-date counts.\nMax: Maximum — Maximum case count during the previous 52 weeks.", "displayType": "table", "publishedAt": "2022-01-18T19:31:36.000Z", "ratingCount": 0, "commentCount": 0, "customFields": { "Common Core": { "Bureau Code": "009:20", "Contact Name": "NNDSS Team", "Program Code": "009:020", "Contact Email": "NNDSSWeb@cdc.gov" } }, "averageRating": 0, "downloadCount": 26861, "rowsUpdatedAt": "2026-08-27T15:35:36.000Z", "hideFromCatalog": false, "publicationStage": "published", "metadataUpdatedAt": "2026-08-27T15:35:35.000Z", "rowIdentifierColumnId": 554475847 } ``` --- ### Datasets CDC open-data catalogue (Socrata discovery API) — no key, direct fetch. This is the only supported way to resolve a dataset id: CDC retires ids without - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/datasets` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `query` | string | query | no | Free-text search across dataset titles, descriptions and columns | | `only` | enum(dataset|chart|map|filter|href) | query | no | Restrict to one asset type. Default all types | | `categories` | string | query | no | Comma-separated category names to filter on | | `tags` | string | query | no | Comma-separated tags to filter on, as listed on a dataset's tags field | | `order` | enum(relevance|name|createdAt|updatedAt|pageViewsLastWeek|pageViewsLastMonth|pageViewsTotal) | query | no | Sort field. Default relevance | | `page` | number | query | no | Page number. Default 1 | | `limit` | number | query | no | Items per page. Default 20, max 100 | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/datasets?query=nndss&only=dataset&categories=NNDSS&tags=wonder&order=pageViewsTotal&page=1&limit=20" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/datasets?query=nndss&only=dataset&categories=NNDSS&tags=wonder&order=pageViewsTotal&page=1&limit=20", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/datasets?query=nndss&only=dataset&categories=NNDSS&tags=wonder&order=pageViewsTotal&page=1&limit=20", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "page": 1, "count": 3, "items": [ { "url": "https://data.cdc.gov/NNDSS/NNDSS-Weekly-Data/x9gk-5huc", "name": "NNDSS Weekly Data", "tags": [ "2023", "2022", "2025", "nndss", "2024", "wonder" ], "type": "dataset", "owner": { "id": "jy77-2p5t", "name": "Nicole Pham", "type": "interactive" }, "domain": "data.cdc.gov", "locked": false, "backend": "nbe", "columns": [ { "name": "States", "dataType": "Number", "fieldName": ":@computed_region_hjsp_umg2", "description": "This column was automatically created in order to record in what polygon from the dataset 'States' (hjsp-umg2) the point in column 'geocode' is located. This enables the creation of region maps (choropleths) in the visualization canvas and data lens." }, { "name": "Reporting Area", "dataType": "Text", "fieldName": "states" }, { "name": "Label", "dataType": "Text", "fieldName": "label" }, { "name": "Cumulative YTD Current MMWR Year, flag", "dataType": "Text", "fieldName": "m3_flag" }, { "name": "Current MMWR Year", "dataType": "Text", "fieldName": "year" }, { "name": "Cumulative YTD Previous MMWR Year", "dataType": "Number", "fieldName": "m4" }, { "name": "MMWR WEEK", "dataType": "Number", "fieldName": "week" }, { "name": "Previous 52 week Max", "dataType": "Number", "fieldName": "m2" } ], "creator": { "id": "jy77-2p5t", "name": "Nicole Pham", "type": "interactive" }, "category": "NNDSS", "metadata": [ { "key": "Common-Core_Bureau-Code", "value": "009:20" }, { "key": "Common-Core_Contact-Name", "value": "NNDSS Team" }, { "key": "Common-Core_Program-Code", "value": "009:020" }, { "key": "Common-Core_Contact-Email", "value": "NNDSSWeb@cdc.gov" } ], "viewType": "tabular", "createdAt": "2021-07-20T14:27:50.000Z", "datasetId": "x9gk-5huc", "pageViews": { "total": 124337, "lastWeek": 1356, "lastMonth": 6533 }, "permalink": "https://data.cdc.gov/d/x9gk-5huc", "updatedAt": "2026-08-27T15:35:36.000Z", "provenance": "official", "attribution": "Office of Public Health Data, Surveillance, and Technology, Centers for Disease Control and Prevention", "description": "NNDSS - In this Table, provisional cases* of notifiable diseases are displayed for United States, U.S. territories, and Non-U.S. residents.\n\n\nNotes:\n• These are weekly cases of selected infectious national notifiable diseases, from the National Notifiable Diseases Surveillance System (NNDSS). NNDSS data reported by the 50 states, New York City, the District of Columbia, and the U.S. territories are collated and published weekly as numbered tables available at https://www.cdc.gov/nndss/infectious-disease/index.html. Cases reported by state health departments to CDC for weekly publication are subject to ongoing revision of information and delayed reporting. Therefore, numbers listed in later weeks may reflect changes made to these counts as additional information becomes available. Case counts in the tables are presented as published each week. See also Guide to Interpreting Provisional and Finalized NNDSS Data.\n\n• Notices, errata, and other notes are available in the Notice To Data Users page https://www.cdc.gov/nndss/infectious-disease/notice-to-data-users.html.\n\n• The list of national notifiable infectious diseases and conditions and their national surveillance case definitions are available at https://ndc.services.cdc.gov/. This list incorporates the Council of State and Territorial Epidemiologists (CSTE) position statements approved by CSTE for national surveillance.\n\nFootnotes:\n*Case counts for reporting years 2024 and 2025 are provisional and subject to change. Cases are assigned to the reporting jurisdiction submitting the case to NNDSS, if the case's country of usual residence is the U.S., a U.S. territory, unknown, or null (i.e. country not reported); otherwise, the case is assigned to the 'Non-U.S. Residents' category. Country of usual residence is currently not reported by all jurisdictions or for all conditions. For further information on interpretation of these data, see https://www.cdc.gov/nndss/docs/Readers-Guide-WONDER-Tables-20210421-508.pdf.\n†Previous 52 week maximum and cumulative YTD are determined from periods of time when the condition was reportable in the jurisdiction (i.e., may be less than 52 weeks of data or incomplete YTD data).\n• Please refer to the Stacks publication for weekly updates to the footnote for influenza-associated pediatric mortality.\nU: Unavailable — The reporting jurisdiction was unable to send the data to CDC or CDC was unable to process the data.\n-: No reported cases — The reporting jurisdiction did not submit any cases to CDC.\nN: Not reportable — The disease or condition was not reportable by law, statute, or regulation in the reporting jurisdiction.\nNN: Not nationally notifiable — This condition was not designated as being nationally notifiable.\nNP: Nationally notifiable but not published.\nNC: Not calculated — There is insufficient data available to support the calculation of this statistic.\nCum: Cumulative year-to-date counts.\nMax: Maximum — Maximum case count during the previous 52 weeks.", "displayType": "table", "publishedAt": "2022-01-18T19:31:36.000Z", "contactEmail": "NNDSSWeb@cdc.gov", "dataUpdatedAt": "2026-08-27T15:35:36.000Z", "downloadCount": 26861, "metadataUpdatedAt": "2026-08-27T15:35:35.000Z" }, { "url": "https://data.cdc.gov/NNDSS/NNDSS-TABLE-1JJ-Tuberculosis-to-Tularemia/tfu6-pjxh", "name": "NNDSS - TABLE 1JJ. Tuberculosis to Tularemia", "tags": [ "nedss", "netss", "nndss", "tuberculosis", "tularemia", "wonder", "2022" ], "type": "dataset", "owner": { "id": "vu8q-ns5k", "name": "aso7@cdc.gov", "type": "interactive" }, "domain": "data.cdc.gov", "locked": false, "backend": "nbe", "columns": [ { "name": "MMWR Year", "dataType": "Text", "fieldName": "mmwr_year" }, { "name": "Tuberculosis, Cum 2021†, flag", "dataType": "Text", "fieldName": "tuberculosis_cum_2021_flag" }, { "name": "Counties", "dataType": "Number", "fieldName": ":@computed_region_skr5_azej", "description": "This column was automatically created in order to record in what polygon from the dataset 'Counties' (skr5-azej) the point in column 'tableonejj' is located. This enables the creation of region maps (choropleths) in the visualization canvas and data lens." }, { "name": "States", "dataType": "Number", "fieldName": ":@computed_region_hjsp_umg2", "description": "This column was automatically created in order to record in what polygon from the dataset 'States' (hjsp-umg2) the point in column 'tableonejj' is located. This enables the creation of region maps (choropleths) in the visualization canvas and data lens." }, { "name": "Tularemia, Current week", "dataType": "Number", "fieldName": "tularemia_current_week" }, { "name": "Tularemia, Cum 2022†", "dataType": "Number", "fieldName": "tularemia_cum_2022" }, { "name": "MMWR Week", "dataType": "Number", "fieldName": "mmwr_week" }, { "name": "Tuberculosis, Previous 52 weeks Max†, flag", "dataType": "Text", "fieldName": "tuberculosis_previous_52_1" } ], "creator": { "id": "vu8q-ns5k", "name": "aso7@cdc.gov", "type": "interactive" }, "category": "NNDSS", "metadata": [ { "key": "Common-Core_Bureau-Code", "value": "009:20" }, { "key": "Common-Core_Contact-Name", "value": "CDC INFO" }, { "key": "Common-Core_Program-Code", "value": "009:020" }, { "key": "Common-Core_Contact-Email", "value": "cdcinfo@cdc.gov" } ], "viewType": "tabular", "createdAt": "2021-12-30T16:42:30.000Z", "datasetId": "tfu6-pjxh", "pageViews": { "total": 31762, "lastWeek": 30, "lastMonth": 1670 }, "permalink": "https://data.cdc.gov/d/tfu6-pjxh", "updatedAt": "2022-02-11T16:35:27.000Z", "provenance": "official", "attribution": "Division of Health Informatics and Surveillance (DHIS), Centers for Disease Control and Prevention", "description": "NNDSS - TABLE 1JJ. Tuberculosis to Tularemia – 2022. In this Table, provisional cases* of notifiable diseases are displayed for United States, U.S. territories, and Non-U.S. residents.\nNotes:\n\n•\tThese are weekly cases of selected infectious national notifiable diseases, from the National Notifiable Diseases Surveillance System (NNDSS). NNDSS data reported by the 50 states, New York City, the District of Columbia, and the U.S. territories are collated and published weekly as numbered tables available at https://www.cdc.gov/nndss/data-statistics/index.html. Cases reported by state health departments to CDC for weekly publication are subject to ongoing revision of information and delayed reporting. Therefore, numbers listed in later weeks may reflect changes made to these counts as additional information becomes available. Case counts in the tables are presented as published each week. See also Guide to Interpreting Provisional and Finalized NNDSS Data at https://www.cdc.gov/nndss/docs/Readers-Guide-WONDER-Tables-20210421-508.pdf.\n• Notices, errata, and other notes are available in the Notice To Data Users page at https://wonder.cdc.gov/nndss/NTR.html.\n•\tThe list of national notifiable infectious diseases and conditions and their national surveillance case definitions are available at https://ndc.services.cdc.gov/. This list incorporates the Council of State and Territorial Epidemiologists (CSTE) position statements approved by CSTE for national surveillance.\n\nFootnotes:\n\n*Case counts for reporting years 2021 and 2022 are provisional and subject to change. Cases are assigned to the reporting jurisdiction submitting the case to NNDSS, if the case's country of usual residence is the U.S., a U.S. territory, unknown, or null (i.e. country not reported); otherwise, the case is assigned to the 'Non-U.S. Residents' category. Country of usual residence is currently not reported by all jurisdictions or for all conditions. For further information on interpretation of these data, see https://www.cdc.gov/nndss/docs/Readers-Guide-WONDER-Tables-20210421-508.pdf.\n†Previous 52 week maximum and cumulative YTD are determined from periods of time when the condition was reportable in the jurisdiction (i.e., may be less than 52 weeks of data or incomplete YTD data).\nU: Unavailable — The reporting jurisdiction was unable to send the data to CDC or CDC was unable to process the data.\n-: No reported cases — The reporting jurisdiction did not submit any cases to CDC.\nN: Not reportable — The disease or condition was not reportable by law, statute, or regulation in the reporting jurisdiction.\nNN: Not nationally notifiable — This condition was not designated as being nationally notifiable.\nNP: Nationally notifiable but not published.\nNC: Not calculated — There is insufficient data available to support the calculation of this statistic.\nCum: Cumulative year-to-date counts.\nMax: Maximum — Maximum case count during the previous 52 weeks.", "displayType": "table", "publishedAt": "2022-01-14T21:25:39.000Z", "contactEmail": "cdcinfo@cdc.gov", "dataUpdatedAt": "2022-02-11T16:35:27.000Z", "downloadCount": 1801, "metadataUpdatedAt": "2022-01-19T19:19:53.000Z" }, { "url": "https://data.cdc.gov/NNDSS/NNDSS-TABLE-1PP-Viral-hemorrhagic-fevers-Sabia-vir/3nij-2pw6", "name": "NNDSS - TABLE 1PP. Viral hemorrhagic fevers, Sabia virus to Zika virus disease, non-congenital", "tags": [ "zika virus disease", "2022", "nedss", "netss", "nndss", "non-congenital", "sabia virus", "viral hemorrhagic fevers" ], "type": "dataset", "owner": { "id": "vu8q-ns5k", "name": "aso7@cdc.gov", "type": "interactive" }, "domain": "data.cdc.gov", "locked": false, "backend": "nbe", "columns": [ { "name": "Zika virus disease, non-congenital, Cum 2022†", "dataType": "Number", "fieldName": "zika_virus_disease_non_4" }, { "name": "Zika virus disease, non-congenital, Cum 2021†", "dataType": "Number", "fieldName": "zika_virus_disease_non_6" }, { "name": "Yellow fever, Current week", "dataType": "Number", "fieldName": "yellow_fever_current_week" }, { "name": "Viral hemorrhagic fevers§, Sabia virus¶, Current week", "dataType": "Number", "fieldName": "viral_hemorrhagic_fevers" }, { "name": "States", "dataType": "Number", "fieldName": ":@computed_region_hjsp_umg2", "description": "This column was automatically created in order to record in what polygon from the dataset 'States' (hjsp-umg2) the point in column 'tableonepp' is located. This enables the creation of region maps (choropleths) in the visualization canvas and data lens." }, { "name": "Counties", "dataType": "Number", "fieldName": ":@computed_region_skr5_azej", "description": "This column was automatically created in order to record in what polygon from the dataset 'Counties' (skr5-azej) the point in column 'tableonepp' is located. This enables the creation of region maps (choropleths) in the visualization canvas and data lens." }, { "name": "Zika virus disease, non-congenital, Current week, flag", "dataType": "Text", "fieldName": "zika_virus_disease_non_1" }, { "name": "Yellow fever, Cum 2021†, flag", "dataType": "Text", "fieldName": "yellow_fever_cum_2021_flag" } ], "creator": { "id": "vu8q-ns5k", "name": "aso7@cdc.gov", "type": "interactive" }, "category": "NNDSS", "metadata": [ { "key": "Common-Core_Bureau-Code", "value": "009:20" }, { "key": "Common-Core_Contact-Name", "value": "CDC INFO" }, { "key": "Common-Core_Program-Code", "value": "009:020" }, { "key": "Common-Core_Contact-Email", "value": "cdcinfo@cdc.gov" } ], "viewType": "tabular", "createdAt": "2022-01-03T14:47:50.000Z", "datasetId": "3nij-2pw6", "pageViews": { "total": 30680, "lastWeek": 14, "lastMonth": 820 }, "permalink": "https://data.cdc.gov/d/3nij-2pw6", "updatedAt": "2022-02-11T16:37:45.000Z", "provenance": "official", "attribution": "Division of Health Informatics and Surveillance (DHIS), Centers for Disease Control and Prevention", "description": "NNDSS - TABLE 1PP. Viral hemorrhagic fevers, Sabia virus to Zika virus disease, non-congenital – 2022. In this Table, provisional cases* of notifiable diseases are displayed for United States, U.S. territories, and Non-U.S. residents.\n\nNotes:\n\n•\tThese are weekly cases of selected infectious national notifiable diseases, from the National Notifiable Diseases Surveillance System (NNDSS). NNDSS data reported by the 50 states, New York City, the District of Columbia, and the U.S. territories are collated and published weekly as numbered tables available at https://www.cdc.gov/nndss/data-statistics/index.html. Cases reported by state health departments to CDC for weekly publication are subject to ongoing revision of information and delayed reporting. Therefore, numbers listed in later weeks may reflect changes made to these counts as additional information becomes available. Case counts in the tables are presented as published each week. See also Guide to Interpreting Provisional and Finalized NNDSS Data at https://www.cdc.gov/nndss/docs/Readers-Guide-WONDER-Tables-20210421-508.pdf.\n• Notices, errata, and other notes are available in the Notice To Data Users page at https://wonder.cdc.gov/nndss/NTR.html.\n•\tThe list of national notifiable infectious diseases and conditions and their national surveillance case definitions are available at https://ndc.services.cdc.gov/. This list incorporates the Council of State and Territorial Epidemiologists (CSTE) position statements approved by CSTE for national surveillance.\n\nFootnotes:\n\n*Case counts for reporting years 2021 and 2022 are provisional and subject to change. Cases are assigned to the reporting jurisdiction submitting the case to NNDSS, if the case's country of usual residence is the U.S., a U.S. territory, unknown, or null (i.e. country not reported); otherwise, the case is assigned to the 'Non-U.S. Residents' category. Country of usual residence is currently not reported by all jurisdictions or for all conditions. For further information on interpretation of these data, see https://www.cdc.gov/nndss/docs/Readers-Guide-WONDER-Tables-20210421-508.pdf.\n†Previous 52 week maximum and cumulative YTD are determined from periods of time when the condition was reportable in the jurisdiction (i.e., may be less than 52 weeks of data or incomplete YTD data).\nU: Unavailable — The reporting jurisdiction was unable to send the data to CDC or CDC was unable to process the data.\n-: No reported cases — The reporting jurisdiction did not submit any cases to CDC.\nN: Not reportable — The disease or condition was not reportable by law, statute, or regulation in the reporting jurisdiction.\nNN: Not nationally notifiable — This condition was not designated as being nationally notifiable.\nNP: Nationally notifiable but not published.\nNC: Not calculated — There is insufficient data available to support the calculation of this statistic.\nCum: Cumulative year-to-date counts.\nMax: Maximum — Maximum case count during the previous 52 weeks.", "displayType": "table", "publishedAt": "2022-01-14T21:51:56.000Z", "contactEmail": "cdcinfo@cdc.gov", "dataUpdatedAt": "2022-02-11T16:37:45.000Z", "downloadCount": 1801, "metadataUpdatedAt": "2022-01-19T19:48:42.000Z" } ], "limit": 3, "query": "nndss", "total": 294, "hasMore": true, "nextPage": 2, "provider": "cdc" } ``` --- ### Mortality Query CDC WONDER mortality query (D-series databases, D76 = Underlying Cause of Death). WONDER answers an incomplete request document with HTTP 500 carrying a parsed, - **Method:** `POST` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/mortality-query` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `database` | string | query | no | WONDER database code. Default D76, Underlying Cause of Death 1999-2020 | | `groupBy` | string | query | no | Comma-separated group-by variable codes, up to 5. Default D76.V1-level1 (year). Location and urbanization codes are refused upstream | | `measures` | string | query | no | Comma-separated measure codes. Default deaths, population and crude rate | | `showTotals` | enum(true|false) | query | no | Append a totals row. Default true | | `parameters` | string | body | no | JSON object of raw WONDER request parameters merged over the baseline document. Use it for value selections such as V_ and F_ codes | | `requestXml` | string | body | no | Complete request document, sent verbatim. Overrides every other field | **cURL:** ```bash curl -X POST "https://api.zpi.web.id/v1/health:cdc/mortality-query" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "parameters": { "V_D76.V1": "2019" }, "requestXml": "" }' ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/mortality-query", { method: "POST", headers: { "x-api-key": process.env.ZAPI_KEY, "Content-Type": "application/json" }, body: JSON.stringify({ "parameters": { "V_D76.V1": "2019" }, "requestXml": "" }) }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.post("https://api.zpi.web.id/v1/health:cdc/mortality-query", headers={"x-api-key": "YOUR_API_KEY"}, json={ "parameters": { "V_D76.V1": "2019" }, "requestXml": "" }) data = r.json() ``` **Example response:** ```json { "count": 23, "items": [ { "type": "data", "year": "1999", "deaths": 2391399, "crudeRate": 857, "population": 279040168 }, { "type": "data", "year": "2000", "deaths": 2403351, "crudeRate": 854, "population": 281421906 }, { "type": "data", "year": "2001", "deaths": 2416425, "crudeRate": 848, "population": 284968955 }, { "type": "data", "year": "2002", "deaths": 2443387, "crudeRate": 849.5, "population": 287625193 }, { "type": "data", "year": "2003", "deaths": 2448288, "crudeRate": 843.9, "population": 290107933 }, { "type": "data", "year": "2004", "deaths": 2397615, "crudeRate": 818.8, "population": 292805298 }, { "type": "data", "year": "2005", "deaths": 2448017, "crudeRate": 828.4, "population": 295516599 }, { "type": "data", "year": "2006", "deaths": 2426264, "crudeRate": 813.1, "population": 298379912 } ], "title": "Underlying Cause of Death, 1999-2020 Results Form", "columns": [ { "key": "year", "code": "D76.V1-level1", "type": "group", "label": "Year" }, { "key": "deaths", "code": "D76.M1", "type": "measure", "label": "Deaths" }, { "key": "population", "code": "D76.M2", "type": "measure", "label": "Population" }, { "key": "crudeRate", "code": "D76.M3", "type": "measure", "label": "Crude Rate" } ], "groupBy": [ "D76.V1-level1" ], "vintage": "2020", "database": "D76", "measures": [ "D76.M1", "D76.M2", "D76.M3" ], "provider": "cdc", "databaseLabel": "Underlying Cause of Death, 1999-2020" } ``` --- ### Tracking Content Areas Environmental Public Health Tracking content areas — the top of the contentArea → indicator → measure hierarchy. The gateway answers HTTP 200 even when it refuses: the real verdict is the - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/tracking-content-areas` - **Cache TTL:** 300s **Parameters:** _No parameters._ **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/tracking-content-areas" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/tracking-content-areas", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/tracking-content-areas", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 27, "items": [ { "name": "Air Quality", "shortName": "AQ", "contentAreaId": 11 }, { "name": "Asthma", "shortName": "AS", "contentAreaId": 3 }, { "name": "Biomonitoring: Population Exposures", "shortName": "BIO", "contentAreaId": 18 }, { "name": "Birth Defects", "shortName": "BD", "contentAreaId": 5 }, { "name": "Built Environment", "shortName": "BE", "contentAreaId": 42 }, { "name": "Cancer", "shortName": "CR", "contentAreaId": 9 }, { "name": "Childhood Cancers", "shortName": "CHCR", "contentAreaId": 10 }, { "name": "Childhood Lead Poisoning", "shortName": "CLP", "contentAreaId": 6 } ], "provider": "cdc" } ``` --- ### Tracking Indicators Indicators inside one Environmental Public Health Tracking content area. The route carries no format segment — `/indicators/{id}/json` is a 400, verified - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/tracking-indicators/:contentAreaId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `contentAreaId` | number | path | yes | Content area id from the tracking-content-areas endpoint | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/tracking-indicators/:contentAreaId" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/tracking-indicators/:contentAreaId", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/tracking-indicators/:contentAreaId", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 13, "items": [ { "name": "Arsenic in Community Water Systems (CWS)", "shortName": "Arsenic in CWS", "indicatorId": 42 }, { "name": "Atrazine in Community Water Systems (CWS)", "shortName": "Atrazine in CWS", "indicatorId": 82 }, { "name": "Di(2-ethylhexyl) phthalate (DEHP) in Community Water Systems (CWS)", "shortName": "DEHP in CWS", "indicatorId": 83 }, { "name": "Disinfection Byproducts in Community Water Systems (CWS)", "shortName": "Byproducts in CWS", "indicatorId": 43 }, { "name": "Nitrates in Community Water Systems (CWS)", "shortName": "Nitrates in CWS", "indicatorId": 44 }, { "name": "Per- and Polyfluoroalkyl Substances (PFAS) in Community Water Systems (CWS)", "shortName": "PFAS in Community Water Systems", "indicatorId": 139 }, { "name": "Perchlorate in Drinking Water", "shortName": "Perchlorate in Drinking Water", "indicatorId": 147 }, { "name": "Private Well Water", "shortName": "Pvt Well Wt", "indicatorId": 240 } ], "provider": "cdc", "contentAreaId": 1 } ``` --- ### Tracking Measures Measures published under one Environmental Public Health Tracking indicator. The route carries no format segment — `/measures/{id}/json` is a 400, verified - **Method:** `GET` - **Endpoint:** `https://api.zpi.web.id/v1/health:cdc/tracking-measures/:indicatorId` - **Cache TTL:** 300s **Parameters:** | Name | Type | Location | Required | Description | |------|------|----------|----------|-------------| | `indicatorId` | number | path | yes | Indicator id from the tracking-indicators endpoint | **cURL:** ```bash curl "https://api.zpi.web.id/v1/health:cdc/tracking-measures/:indicatorId" \ -H "x-api-key: YOUR_API_KEY" ``` **JavaScript / TypeScript:** ```javascript const res = await fetch("https://api.zpi.web.id/v1/health:cdc/tracking-measures/:indicatorId", { headers: { "x-api-key": process.env.ZAPI_KEY } }); const data = await res.json(); ``` **Python:** ```python import requests r = requests.get("https://api.zpi.web.id/v1/health:cdc/tracking-measures/:indicatorId", headers={"x-api-key": "YOUR_API_KEY"}) data = r.json() ``` **Example response:** ```json { "count": 5, "items": [ { "name": "Annual Mean Concentration of Arsenic (µg/L)", "measureId": 769, "shortName": "Annual mean Arsenic concentrations (µg/L)", "temporalsSortedAscending": false }, { "name": "Annual Percent of CWS by Maximum Arsenic Concentrations (µg/L)", "measureId": 1047, "shortName": "Percent of CWS by annual maximum Arsenic concentrations (µg/L)", "temporalsSortedAscending": false }, { "name": "Annual Percent of CWS by Mean Arsenic Concentrations (µg/L)", "measureId": 1045, "shortName": "Percent of CWS by annual mean Arsenic concentrations (µg/L)", "temporalsSortedAscending": false }, { "name": "Annual Percent of People Served by CWS by Maximum Arsenic Concentrations (µg/L)", "measureId": 1048, "shortName": "Percent Population served by CWS by annual maximum Arsenic concentrations (µg/L)", "temporalsSortedAscending": false }, { "name": "Annual Percent of People Served by CWS by Mean Arsenic Concentrations (µg/L)", "measureId": 1046, "shortName": "Percent of population served by CWS by annual mean Arsenic concentrations (µg/L)", "temporalsSortedAscending": false } ], "provider": "cdc", "indicatorId": 42 } ``` --- _Generated: 2026-08-30T05:09:34.333Z_