GET /resource/{datasetId}.json

cdc.gov:cdc-socrata-api

Summary: Query dataset records
Operation ID: queryDataset
Auth: unknown
Description

Query and retrieve records from a specific dataset using SoQL (Socrata Query Language) parameters for filtering, sorting, and pagination.

Parameters (7)

$group (string, query, optional)

SoQL group clause for aggregation (e.g., 'year')

$limit (integer, query, optional, default: 1000)

Maximum number of records to return (default: 1000, max: 50000)

Constraints: {'minimum': 1, 'maximum': 50000}

$offset (integer, query, optional, default: 0)

Number of records to skip (for pagination)

Constraints: {'minimum': 0}

$order (string, query, optional)

SoQL order clause for sorting (e.g., 'year DESC')

$select (string, query, optional)

SoQL select clause to specify columns (e.g., 'year, state, count')

$where (string, query, optional)

SoQL where clause for filtering records (e.g., 'year > 2020 AND state = "California"')

datasetId (string, path, required)

The unique identifier of the dataset (4x4 format, e.g., jkcx-ndu8)

Constraints: {'pattern': '^[a-z0-9]{4}-[a-z0-9]{4}$'}

Examples (1)

TitleTypeURLAction
Query dataset records with SODA probe-gate https://data.cdc.gov/resource/sz5x-j2c3.json?$limit=5

No probe data for this endpoint yet.