Hhs Gov HHS Media Services API

Name: HHS Media Services API
Brand: HHS Media Services API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHealthcareClinical Datanone31 EndpointsREST

For Agents

Search and retrieve U.S. HHS public-health media items, campaigns, sources, tags, and embed code from a read-only government syndication library — no authentication required.

Install Jentic One Beta

Connect the HHS Media Services API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the HHS Media Services API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with HHS Media Services API.

Search the HHS media library by keyword via GET /resources/media/searchResults.json

List public health campaigns and pull media tied to a specific campaign through /resources/campaigns/{id}/media.json

Retrieve ready-to-embed snippets for a media item via GET /resources/media/{id}/embed.json

GET STARTED

Start building with HHS Media Services API

Explore with Jentic

View OpenAPI Document

The HHS Media Services API exposes the U.S. Department of Health & Human Services syndicated content library — public health campaigns, media items, languages, sources, and tags — for embedding in third-party sites and applications. Across 31 GET endpoints, integrators can search media items by keyword, list campaigns, retrieve campaign-specific media, fetch ready-to-embed snippets, and pull thumbnails or YouTube metadata. The API supports multi-column sorting via a sort query parameter (with a leading hyphen for descending order) and RFC 3339 dates, and is read-only with no authentication.

Use Cases

Patterns agents use HHS Media Services API for, with concrete tasks.

★ Public Health Content Embedding

Community health sites and clinic portals embed HHS-curated content by calling GET /resources/media/{id}/embed.json to fetch HTML snippets or GET /resources/media/{id}/syndicate.{format} for the syndication payload. Content stays current automatically because the snippets reference HHS-hosted assets, so updated guidance flows through without site redeployments.

Call GET /resources/media/{id}/embed.json for the chosen media id and place the returned HTML in a clinic site's resource page.

Campaign Aggregation

Researchers and policy teams pull a list of public health campaigns via GET /resources/campaigns.json and drill into each via /resources/campaigns/{id}/media.json to study how HHS messages a topic across formats. Combined with the tags endpoints, this enables longitudinal analysis of campaign breadth and language coverage.

Call GET /resources/campaigns.json, then for each campaign id call /resources/campaigns/{id}/media.json and aggregate the media counts by language.

Multilingual Health Content Discovery

Localised community sites use GET /resources/languages.json to map ISO codes to HHS language ids, then filter media searches via GET /resources/media/searchResults.json to surface content in a visitor's language. The tags vocabulary lets the same site offer topic-based browsing aligned with HHS taxonomies.

Call GET /resources/languages.json to find the Spanish id, then GET /resources/media/searchResults.json with that language id and a topic keyword.

AI Agent Health Information Lookup

Through Jentic, an AI agent answering a health-information question can search HHS Media Services for authoritative content and surface the embed link in its response. Because the API is unauthenticated, Jentic simply routes the GET requests; there is no key to manage, and the agent can cite a government source directly.

Search Jentic for 'search hhs media items', execute GET /resources/media/searchResults.json with q=diabetes, and return the top three titles with their embed URLs.

Key Endpoints

31 endpoints — the hhs media services api exposes the u.

METHOD

PATH

DESCRIPTION

GET

/resources/media/searchResults.json

Search media items by keyword

GET

/resources/media/{id}.json

Get a media item by id

GET

/resources/media/{id}/embed.json

Get embed code for a media item

GET

/resources/campaigns.json

List public health campaigns

GET

/resources/campaigns/{id}/media.json

List media items for a campaign

GET

/resources/languages.json

List supported languages

GET

/resources/tags.{format}

List the tag vocabulary

GET

/resources/media/searchResults.json

Search media items by keyword

GET

/resources/media/{id}.json

Get a media item by id

GET

/resources/media/{id}/embed.json

Get embed code for a media item

GET

/resources/campaigns.json

List public health campaigns

GET

/resources/campaigns/{id}/media.json

List media items for a campaign

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The HHS Media Services API is unauthenticated, so there is no credential to manage. Jentic still wraps the calls with consistent retry and observability so the agent treats this API the same way it treats authenticated ones.

Intent-based discovery

Agents search by intent (e.g., 'search hhs media items' or 'list public health campaigns') and Jentic returns the matching HHS operation with its input schema, so the agent calls the right endpoint without scanning the spec.

Time to first call

Direct HHS integration: half a day to handle the multi-format responses and sort syntax. Through Jentic: minutes — search, load schema, execute.

FAQs

Specific to using HHS Media Services API through Jentic.

What authentication does the HHS Media Services API use?

The HHS Media Services API is a public, read-only syndication API and does not require authentication. Jentic still routes calls through its runtime so you get consistent retry, observability, and rate-aware behaviour even though no credential is exchanged.

Can I embed HHS media on my site through the API?

Yes. GET /resources/media/{id}/embed.json returns embed-ready code for a chosen media item, and /resources/media/{id}/syndicate.{format} returns the underlying syndicated payload in JSON or another format. Updated content flows through automatically because the embed references HHS-hosted assets.

How does sorting work on HHS list endpoints?

List endpoints accept a sort query parameter that supports multiple columns separated by commas. Prefix a field with a hyphen for descending order — for example, sort=-name,id sorts by name descending, then id ascending. Date inputs follow RFC 3339, e.g., 2013-11-18T18:43:01Z.

How do I search HHS media items through Jentic?

Run pip install jentic, search for 'search hhs media items', and execute against GET /resources/media/searchResults.json with q=<keyword>. Jentic returns the JSON payload with matching media items and their ids for follow-up calls.

Are there rate limits on the HHS Media Services API?

HHS does not publish hard rate limits in the spec. Treat the API as a public good — cache responses, avoid tight polling, and back off on any error responses. Bulk syndication is best done via the /syndicate.{format} endpoints which return larger payloads in one call.