Eufy API

From Michael's Information Zone
Jump to navigation Jump to search


To programatically work with Eufy products.

In the following example I want to turn on a smart plug that is attached to a HEPA air filter. I want this to be turned on when the PM in the air gets to a high enough level. The filter works well in filtering the air, but it can be loud and I don't want it running 24/7.


[1]I am having a hard time finding official documentation, but I did find a forum post with some information. There is also a great project on github that was able to point me in the right direction[2]


This was rather confusing. Pulling from various sources I realized that all existing projects pull from the same source. Someone had decrypted the API calls[3] and hardcoded the following for headers. My guess is that Eufy uses this for most calls and it is required.

client_id = "eufyhome-app"
client_secret = "GQCpr9dSp3uQpsOMgJ4xQ"

Working with Devices

In order to work with the devices, you have to encrypt the commands and send directly to the device. This means you must be able to route to the device and not simply control it over the internet, like you would with the mobile app.

Turn switch on/off

Using the lakeside project[4] I was able to lookup the switch in question, then turn it on and off.

git clone
cd python-lakeside

Write the script to call the functions

import lakeside, json

test=lakeside.get_devices('email address', 'password')
for i in test:
    if i['name'] == 'Filter':
switch=lakeside.switch(ip, code, dev)