Search Datasets
search_datasetsRead-onlyIdempotent
Search HealthData.gov for public-health datasets by keyword (e.g. "COVID hospitalizations", "Medicare spending", "opioid prescriptions"). Returns each dataset's Socrata id (a 4x4 like "g62h-syeh"), title, description, owning agency, tags, when the data was last updated, and its page-view count. Pass the id to get_dataset for full metadata or to get_rows to read the actual rows.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results, 1-50 (default 10). | |
| query | Yes | Search query, e.g. "vaccination rates", "hospital readmissions". | |
| offset | No | Skip this many results, for paging (default 0). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Total number of datasets matching the search query | |
| results | Yes | Array of matching datasets |