Centers for Disease Control and Prevention website screenshot

Centers for Disease Control and Prevention

The Centers for Disease Control and Prevention (CDC) is the United States' national public health agency, part of the Department of Health and Human Services. CDC operates a broad portfolio of public APIs and open data services including the Socrata-powered data.cdc.gov (Open Data API for hundreds of COVID-19, chronic disease, environmental health, immunization, injury, and mortality datasets), the WONDER online query databases for mortality, natality, and cancer statistics, the PLACES / BRFSS and Environmental Public Health Tracking Network APIs, the Content Syndication platform, and the open.cdc.gov developer portal that indexes these resources for civic technologists and public-health researchers.

7 APIs 0 Features
CDCEnvironmental HealthEpidemiologyFederal GovernmentHealthcareOpen DataPublic HealthSocrataSurveillanceWONDER

APIs

CDC Socrata Open Data API (data.cdc.gov)

The CDC Socrata Open Data API (SODA) provides programmatic JSON, CSV, and GeoJSON access to hundreds of data.cdc.gov datasets covering COVID-19 case surveillance, vaccination co...

CDC WONDER API

CDC WONDER (Wide-ranging ONline Data for Epidemiologic Research) is a suite of public-use ad-hoc query databases covering underlying and multiple cause of death, natality, cance...

CDC PLACES / 500 Cities API

PLACES (Population Level Analysis and Community Estimates) provides model-based small-area estimates for chronic disease risk factors, health outcomes, and prevention practices ...

CDC Environmental Public Health Tracking Network API

The Environmental Public Health Tracking Network API provides a REST interface over the National Tracking Network's JSON-formatted data for air quality, water quality, climate a...

CDC Public Health Media Library (Content Syndication)

The CDC Public Health Media Library Content Syndication API lets developers and partner sites programmatically retrieve CDC health content (articles, infographics, videos, widge...

CDC Open Technology API Index

open.cdc.gov is CDC's Open Technology landing site that indexes the agency's public APIs, open-source GitHub repositories, and open data assets, serving as a catalog entry point...

CDC NNDSS / MMWR Socrata Data

The National Notifiable Diseases Surveillance System (NNDSS) and Morbidity and Mortality Weekly Report (MMWR) tables are published as Socrata datasets on data.cdc.gov, providing...

Collections

CDC Socrata Open Data API (data.cdc.gov)

OPEN

Pricing Plans

Centers For Disease Control And Prevention Plans Pricing

3 plans

PLANS

Rate Limits

Centers For Disease Control And Prevention Rate Limits

5 limits

RATE LIMITS

FinOps

Centers For Disease Control And Prevention Finops

FINOPS

Resources

🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
OpenData
OpenData
🌐
Portal
Portal
🔗
APIs
APIs
👥
GitHubOrganization
GitHubOrganization
🔗
WONDER
WONDER
🔗
Socrata
Socrata
🔗
ContentSyndication
ContentSyndication
🔗
EPHTN
EPHTN
📜
PrivacyPolicy
PrivacyPolicy

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: CDC Socrata Open Data API (data.cdc.gov)
  version: '2.1'
request:
  auth:
    type: apikey
    key: X-App-Token
    value: '{{X-App-Token}}'
    placement: header
items:
- info:
    name: SODA v2.1
    type: folder
  items:
  - info:
      name: Query a dataset (JSON)
      type: http
    http:
      method: GET
      url: https://data.cdc.gov/resource/:dataset_id.json
      params:
      - name: dataset_id
        value: ''
        type: path
        description: Eight-character dataset identifier (four-four with a dash).
      - name: $select
        value: ''
        type: query
        description: Columns to return (SoQL SELECT clause).
      - name: $where
        value: ''
        type: query
        description: Row filter (SoQL WHERE clause).
      - name: $order
        value: ''
        type: query
        description: Ordering (SoQL ORDER BY clause).
      - name: $group
        value: ''
        type: query
        description: Grouping (SoQL GROUP BY clause).
      - name: $having
        value: ''
        type: query
        description: Post-grouping filter (SoQL HAVING clause).
      - name: $limit
        value: ''
        type: query
        description: Maximum rows to return.
      - name: $offset
        value: ''
        type: query
        description: Row offset for pagination.
      - name: $q
        value: ''
        type: query
        description: Full-text search across the dataset.
      - name: $query
        value: ''
        type: query
        description: Full SoQL query, overriding individual $select/$where/etc.
      - name: $$app_token
        value: ''
        type: query
        description: Socrata application token (alternative to X-App-Token header).
    docs: 'Returns rows from a dataset as JSON. Supports SoQL via $select,

      $where, $order, $group, $limit, $offset, and $q parameters.

      '
  - info:
      name: Query a dataset (CSV)
      type: http
    http:
      method: GET
      url: https://data.cdc.gov/resource/:dataset_id.csv
      params:
      - name: dataset_id
        value: ''
        type: path
        description: Eight-character dataset identifier (four-four with a dash).
      - name: $select
        value: ''
        type: query
        description: Columns to return (SoQL SELECT clause).
      - name: $where
        value: ''
        type: query
        description: Row filter (SoQL WHERE clause).
      - name: $order
        value: ''
        type: query
        description: Ordering (SoQL ORDER BY clause).
      - name: $group
        value: ''
        type: query
        description: Grouping (SoQL GROUP BY clause).
      - name: $having
        value: ''
        type: query
        description: Post-grouping filter (SoQL HAVING clause).
      - name: $limit
        value: ''
        type: query
        description: Maximum rows to return.
      - name: $offset
        value: ''
        type: query
        description: Row offset for pagination.
      - name: $query
        value: ''
        type: query
        description: Full SoQL query, overriding individual $select/$where/etc.
      - name: $$app_token
        value: ''
        type: query
        description: Socrata application token (alternative to X-App-Token header).
    docs: Query a dataset (CSV)
  - info:
      name: Query a dataset (GeoJSON)
      type: http
    http:
      method: GET
      url: https://data.cdc.gov/resource/:dataset_id.geojson
      params:
      - name: dataset_id
        value: ''
        type: path
        description: Eight-character dataset identifier (four-four with a dash).
      - name: $where
        value: ''
        type: query
        description: Row filter (SoQL WHERE clause).
      - name: $limit
        value: ''
        type: query
        description: Maximum rows to return.
      - name: $offset
        value: ''
        type: query
        description: Row offset for pagination.
      - name: $query
        value: ''
        type: query
        description: Full SoQL query, overriding individual $select/$where/etc.
      - name: $$app_token
        value: ''
        type: query
        description: Socrata application token (alternative to X-App-Token header).
    docs: Query a dataset (GeoJSON)
- info:
    name: SODA v3
    type: folder
  items:
  - info:
      name: Query a dataset (SODA v3, GET)
      type: http
    http:
      method: GET
      url: https://data.cdc.gov/api/v3/views/:dataset_id/query.json
      params:
      - name: dataset_id
        value: ''
        type: path
        description: Eight-character dataset identifier (four-four with a dash).
      - name: $query
        value: ''
        type: query
        description: Full SoQL query, overriding individual $select/$where/etc.
      - name: $$app_token
        value: ''
        type: query
        description: Socrata application token (alternative to X-App-Token header).
    docs: Query endpoint with v3 options and machine-readable response.
  - info:
      name: Query a dataset (SODA v3, POST)
      type: http
    http:
      method: POST
      url: https://data.cdc.gov/api/v3/views/:dataset_id/query.json
      params:
      - name: dataset_id
        value: ''
        type: path
        description: Eight-character dataset identifier (four-four with a dash).
      - name: $$app_token
        value: ''
        type: query
        description: Socrata application token (alternative to X-App-Token header).
      body:
        type: json
        data: '{}'
    docs: Preferred method for longer queries. Body is SoQL/$query payload.
  - info:
      name: Export a dataset (human-readable)
      type: http
    http:
      method: GET
      url: https://data.cdc.gov/api/v3/views/:dataset_id/export.:format
      params:
      - name: dataset_id
        value: ''
        type: path
        description: Eight-character dataset identifier (four-four with a dash).
      - name: format
        value: ''
        type: path
      - name: $$app_token
        value: ''
        type: query
        description: Socrata application token (alternative to X-App-Token header).
    docs: Export a dataset (human-readable)
bundled: true