home-assistant.io/source/_integrations/shodan.markdown

title	description	ha_category	ha_iot_class	ha_release	ha_codeowners	ha_domain	ha_platforms	ha_integration_type
Shodan	Instructions on how to integrate Shodan sensors into Home Assistant.	Sensor	Cloud Polling	0.51	@fabaff	shodan	sensor	integration

The shodan sensor platform is displaying the total of result of a Shodan query.

Use "Show API Key" in the upper right corner when you are logged in or got to your "My Account" page to retrieve your API key.

To enable this sensor, add the following lines to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: shodan
    api_key: SHODAN_API_KEY
    query: "home-assistant"

{% configuration %} api_key: description: The API key for Shodan.io. required: true type: string query: description: The search string. required: true type: string name: description: Name of the Shodan sensor. required: false type: string {% endconfiguration %}