home-assistant.io/source/_components/sensor.shodan.markdown

layout	title	description	date	sidebar	comments	sharing	footer	ha_category	ha_iot_class	logo	ha_release
page	Shodan Sensor	Instructions how to integrate Shodan sensors into Home Assistant.	2017-08-09 10:30	true	false	true	true	Sensor	Cloud Polling	shodan.png	0.51

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 %}