---
id: aiotractive
version: "1.0.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# aiotractive — Asynchronous Python client for the Tractive REST API

License: permissive · Maintenance: active · Downloads: 75.0K/mo

## What it is and what it does

aiotractive is an unofficial async Python wrapper around Tractive's REST API for pet tracking devices. It provides programmatic access to tracker status, historical positions, device control (buzzer, LED, live tracking), and real-time event streaming. The package is built on aiohttp for async I/O and includes full type hints for static analysis.

The library is in active development but not feature-complete relative to the Tractive web app. It requires an active Tractive subscription and valid credentials. Since it reverse-engineers Tractive's undocumented API, breaking changes may occur if Tractive modifies their endpoints. The project has low install friction and no known security vulnerabilities.

Use it for:

- Build home automation integrations that fetch pet location and battery status from Tractive trackers
- Stream real-time tracker events to a monitoring dashboard or alerting system
- Retrieve historical position data for pet movement analysis or reporting
- Programmatically control tracker features like buzzer and LED from custom applications
- Develop bot or script that periodically checks tracker status and notifies on location changes

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asynchronous Python client for the Tractive pet tracking REST API, enabling programmatic access to tracker status, location history, device control, and real-time events.

Yes, if you own Tractive devices and need async Python access to their API. The package has low install friction, active maintenance, permissive licensing, and no known vulnerabilities. Be aware it is reverse-engineered (not official), in alpha status, and may break if Tractive changes their API. Not suitable if you need guaranteed API stability or comprehensive feature coverage.

## Install

pip install aiotractive
uv add aiotractive
poetry add aiotractive

## Installing aiotractive

Before you install: Low install friction with pure Python dependencies (aiohttp, orjson, yarl). Active maintenance with recent commits and no known vulnerabilities. Supports Python 3.9 through 3.14.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the original license notice.

Quickstart:

pip install aiotractive

import asyncio
from aiotractive import Tractive

async def main():
    async with Tractive("email", "password") as client:
        trackers = await client.trackers()
        for tracker in trackers:
            pos = await tracker.pos_report()
            print(pos)

asyncio.run(main())

Requires an active Tractive subscription and valid account credentials. Tractive may change their API at any time, potentially breaking this reverse-engineered client.

Verify before relying:

- Completeness of API coverage relative to the Tractive web app's full feature set
- Stability guarantees or SLA for the reverse-engineered API endpoints
- Whether all tracker models and device types are supported

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 75.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

tractive api client, pet tracker async python, tractive device control, async gps tracking, tractive rest api wrapper, async-io, pet-tracking, rest-client

[View on SkillFed](https://skillfed.io/packages/aiotractive) · [View on PyPI](https://pypi.org/project/aiotractive/)