PetKitAIO

Asynchronous Python library for PetKit's API.

This is PetKit's undocumented API. With that said, future changes made by PetKit may break this library. The API endpoint used is determined based on the region your account is locked to. See the Regions section for available region values.

Currently Supported Devices:

Feeders

• Fresh Element
• D3 (Fresh Element Infinity)
• D4 (Fresh Element Solo)
• D4s (Fresh Element Gemini)
• Mini Feeder

Litter Boxes

• T3 (Pura X)
• T4 (Pura MAX / Pura MAX 2) with/without Pura Air

Purifiers

• K2 (Air Magicube)

Water Fountains

• W5 (Eversweet Solo 2)
• W5 (Eversweet 3 Pro)
• W5 (Eversweet 3 Pro UVC Version)
• W5 (Eversweet 5 Mini)

Important

PetKit accounts can only be logged in on one device at a time. Using this library will result in getting signed out of the mobile app. If you want to continue using the mobile app, use the family share feature to share devices to a secondary account.

[!NOTE] The secondary account may be used with this library. However, be aware that this library was created with a primary account - using a secondary account with this library will work, but I can't guarantee that all features will work.

This package depends on aiohttp and tzlocal. Python 3.7 or greater is required.

Usage

Regions

---

<details> <summary> <b>See regions available</b> (<i>click to expand</i>)</summary> <!---->

| Region | |-------------------------------------------------------| | Afghanistan | | Aland Islands | | Albania | | Algeria | | American Samoa | | Andorra | | Angola | | Anguilla | | Antarctica | | Antigua and Barbuda | | Argentina | | Armenia | | Aruba | | Australia | | Austria | | Azerbaijan | | Bahamas | | Bahrain | | Bangladesh | | Barbados | | Belarus | | Belgium | | Belize | | Benin | | Bermuda | | Bhutan | | Bolivia | | Bosnia and Herzegovina | | Botswana | | Bouvet Island | | Brazil | | British Indian Ocean Territory | | Brunei Darussalam | | Bulgaria | | Burkina Faso | | Burundi | | Cambodia | | Cameroon | | Canada | | Cape Verde | | Cayman Islands | | Central African Republic | | Chad | | Chile | | China | | Christmas Island | | Cocos (Keeling) Islands | | Colombia | | Comoros | | Congo | | Congo (the Democratic Republic of the Congo) | | Cook Islands | | Costa Rica | | Côte d'Ivoire | | Croatia | | Cuba | | Cyprus | | Czech Republic | | Denmark | | Djibouti | | Dominica | | Dominican Republic | | Ecuador | | Egypt | | El Salvador | | Equatorial Guinea | | Eritrea | | Estonia | | Ethiopia | | Falkland Islands [Malvinas] | | Faroe Islands | | Fiji | | Finland | | France | | French Guiana | | French Polynesia | | French Southern Territories | | Gabon | | Gambia | | Georgia | | Germany | | Ghana | | Gibraltar | | Greece | | Greenland | | Grenada | | Guadeloupe | | Guam | | Guatemala | | Guernsey | | Guinea | | Guinea-Bissau | | Guyana | | Haiti | | Heard Island and McDonald Islands | | Holy See [Vatican City State] | | Honduras | | Hong Kong | | Hungary | | Iceland | | India | | Indonesia | | Iran (the Islamic Republic of Iran) | | Iraq | | Ireland | | Isle of Man | | Israel | | Italy | | Jamaica | | Japan | | Jersey | | Jordan | | Kazakhstan | | Kenya | | Kiribati | | Korea (the Democratic People's Republic of Korea) | | Korea (the Republic of Korea) | | Kuwait | | Kyrgyzstan | | Lao People's Democratic Republic | | Latvia | | Lebanon | | Lesotho | | Liberia | | Libyan Arab Jamahiriya | | Liechtenstein | | Lithuania