Home Assistant Integrations Scraper

Extract integrations from the Home Assistant official catalog — 1,400+ smart home integrations covering lighting, climate, media, energy, security, and more.

What does this actor do?

Home Assistant is the world's most popular open-source home automation platform. Its integration catalog documents all supported devices, services, and protocols. This actor scrapes the catalog to help you:

• Search integrations by keyword (e.g., "philips", "sonos", "nest")
• Browse by IoT class (Local Push, Cloud Polling, etc.), quality scale, or integration type
• Fetch specific integrations by domain name

Each record includes the domain name, title, description, IoT class, quality scale, integration type, and a link to the official documentation.

Modes

Mode	Description
search	Full-text search in title, description, and domain
browse	Filter integrations by IoT class, quality scale, or type
getByDomain	Fetch one or more specific integrations by domain name

Input

Parameter	Type	Description
mode	String (required)	Operation mode: search, browse, or getByDomain
query	String	Keyword to search for (mode=search)
iotClass	String	Filter by IoT communication class (mode=browse)
qualityScale	String	Filter by quality tier: platinum, gold, silver, bronze, legacy, internal
integrationType	String	Filter by type: integration, device, service, hub, helper, etc.
domains	Array	Domain names to fetch (mode=getByDomain)
maxItems	Integer	Maximum number of records (1–10000, default 100)

Example: Search for Philips integrations

{
  "mode": "search",
  "query": "philips",
  "maxItems": 10
}

Example: Browse all platinum-quality local push integrations

{
  "mode": "browse",
  "iotClass": "Local Push",
  "qualityScale": "platinum",
  "maxItems": 50
}

Example: Get specific integrations by domain

{
  "mode": "getByDomain",
  "domains": ["hue", "mqtt", "sonos", "nest"],
  "maxItems": 10
}

Output

Each record contains:

Field	Type	Description
domain	String	Integration domain name (e.g., hue)
title	String	Integration display name
description	String	What the integration does
qualityScale	String	Quality tier: platinum, gold, silver, bronze, legacy, internal
iotClass	String	Communication method: Local Push, Cloud Polling, etc.
integrationType	String	Type: integration, device, service, hub, helper, etc.
docUrl	String	URL to the official Home Assistant documentation page
isLocalIntegration	Boolean	True if the integration communicates locally (not via cloud)
isCloudIntegration	Boolean	True if the integration requires cloud connectivity
sourceUrl	String	Same as docUrl — canonical URL for this record
recordType	String	Always integration
scrapedAt	String	ISO 8601 timestamp of when the record was scraped

Sample output

{
  "domain": "hue",
  "title": "Philips Hue",
  "description": "Instructions on setting up Philips Hue within Home Assistant.",
  "qualityScale": "platinum",
  "iotClass": "Local Push",
  "integrationType": "hub",
  "docUrl": "https://www.home-assistant.io/integrations/hue/",
  "isLocalIntegration": true,
  "isCloudIntegration": false,
  "sourceUrl": "https://www.home-assistant.io/integrations/hue/",
  "recordType": "integration",
  "scrapedAt": "2026-05-30T12:00:00+00:00"
}

IoT Classes

IoT Class	Description
Local Push	Device pushes state changes to Home Assistant locally (no cloud)
Local Polling	Home Assistant polls the device locally (no cloud)
Cloud Push	Cloud service pushes state changes to Home Assistant
Cloud Polling	Home Assistant polls a cloud service for state
Assumed State	State is assumed (e.g., after sending a command), not verified
Calculated	State is derived/calculated from other entities

Quality Scales

Scale	Description
platinum	Highest quality — full test coverage, strict code review
gold	High quality — well maintained, good test coverage
silver	Good quality — stable, functional tests
bronze	Basic quality — functional but minimal tests
legacy	Older integration — maintained but not actively improved
internal	Internal Home Assistant integration (e.g., helpers, utilities)

FAQ

Is authentication required? No. The integration catalog is publicly available at https://www.home-assistant.io/integrations.json.

How many integrations are available? Over 1,400 integrations at time of writing, covering smart home devices, cloud services, protocols, and utilities.

What is the domain field? The domain is Home Assistant's internal identifier for an integration (e.g., hue for Philips Hue, mqtt for MQTT). It's the URL slug in the documentation: https://www.home-assistant.io/integrations/{domain}/.

Can I find only locally-controlled integrations? Yes — use iotClass: "Local Push" or iotClass: "Local Polling" in browse mode to find integrations that work without internet connectivity.

Can I filter by multiple criteria? Yes — the browse mode supports combining iotClass, qualityScale, and integrationType filters simultaneously.