# HealthData.gov Dataset Catalogue Search

> HealthData.gov Dataset Catalogue Search is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches the HealthData.gov (HHS) dataset catalogue and returns dataset ID, name, short description, display type, last rows update, and dataset link for a given search term.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/healthdata?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/healthdata-gov-dataset-catalogue-search-ec4d7f8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SpqfmUbgbvr8w1HZszyWK

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability healthdata-gov-dataset-catalogue-search-ec4d7f8d
```

Example prompt: Search HealthData.gov for up to 5 datasets related to 'diabetes' and show me their names, descriptions, and links.

## When to prefer this

Use this endpoint when you need to discover what public health datasets exist on HealthData.gov for a given topic, without needing to access the actual row-level data. Ideal for research scoping, identifying HHS dataset IDs for downstream access, or building a catalogue of available federal health data resources. Prefer this over general web search when you specifically need structured catalogue metadata (IDs, update dates, direct links) from the HHS open data portal.

## Known failure modes

- Query string shorter than 2 or longer than 80 characters returns an error
- No matching datasets found returns an empty datasets array
- Non-tabular datasets (displayType 'href') have no row-level API, only catalogue metadata
- Rate limiting or upstream HealthData.gov API unavailability may cause failures
- Limit parameter outside 1–10 range may be rejected or clamped

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

Returns a JSON object containing the original search query, the source URL (healthdata.gov catalogue API), and an array of up to 10 dataset records. Each record includes the dataset ID, direct URL, name, truncated description, display type (e.g. 'href' for non-tabular), and last rows update date. Also includes a checkedAt timestamp indicating when the catalogue was queried.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search text, 2 to 80 characters"
      },
      "limit": {
       "type": "string",
       "description": "Datasets to return, 1 to 10 (default 5)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "covid",
  "source": "https://healthdata.gov/api/views.json",
  "datasets": [
   {
    "id": "h2zy-xhqp",
    "url": "https://healthdata.gov/d/h2zy-xhqp",
    "name": "Meningococcal Disease (Invasive) Activity in California",
    "description": "Data represent invasive meningococcal disease cases classified by local health jurisdictions as Confirmed and Probable with an episode date from January 1, 2026 through the last month indicated. The source of data is the California Confidential Morbidity Reports and/or Laboratory Reports submitted t",
    "displayType": "href",
    "lastRowsUpdate": "2026-10-21"
   },
   {
    "id": "k7hb-9fbz",
    "url": "https://healthdata.gov/d/k7hb-9fbz",
    "name": "A biomechanics-based conceptual design of spring knee-aid",
    "description": "Occupational activities that require high knee-flexion tasks are associated with a higher prevalence of knee osteoarthritis (OA) compared to the general population. Spring knee-aids have been used to protect the knee joints during dynamic high knee-flexion tasks. The objective of this study was to d",
    "displayType": "href",
    "lastRowsUpdate": "2026-10-20"
   }
  ],
  "checkedAt": "2026-10-23T09:37:29.656Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/healthdata-gov-dataset-catalogue-search-ec4d7f8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)