Spotlite

0.10.0 verified Sat May 09 auth: no python

Spotlite is a Python client library for interacting with Satellogic APIs, simplifying authentication, data catalog queries, and order management. Version 0.10.0 requires Python >= 3.11.5 and is under active development.

pip install spotlite

Common errors

error spotlite.exceptions.AuthError: Invalid credentials ↓

cause Username or password are incorrect or environment variables not set correctly.

fix

Verify SATLOGIC_USER and SATLOGIC_PASS are valid and set in environment.

error AttributeError: 'SatellogicClient' object has no attribute 'get_asset' ↓

cause Using deprecated method get_asset which was removed in newer versions.

fix

Use get_asset_details instead.

error TypeError: Object of type datetime is not JSON serializable ↓

cause Passing a datetime object directly as a parameter without conversion.

fix

Convert datetime to ISO format string before passing to API calls.

Warnings

breaking In version 0.10.0, the 'orders' endpoint was restructured; order creation now requires explicit payload fields. Old code that passed dictionaries directly will break. ↓

fix Update order creation to use the new payload structure as documented in the official docs.

deprecated The `get_asset` method is deprecated in favor of `get_asset_details`. Using the old method will produce a warning. ↓

fix Replace `client.get_asset(id)` with `client.get_asset_details(id)`.

gotcha Authentication tokens expire after 24 hours. The client does not auto-refresh; you must re-authenticate. ↓

fix Wrap long-running sessions in a try-except for AuthError and re-login if needed.

Imports

SatellogicClient
wrong
```
import spotlite
```
correct
```
from spotlite import SatellogicClient
```
Direct import of module does not directly expose SatellogicClient; must import explicitly.

AuthError

wrong

from spotlite import AuthError

correct

from spotlite.exceptions import AuthError

AuthError is in the exceptions submodule, not top-level.

Quickstart

Authenticate with Satellogic credentials and fetch the catalog.

from spotlite import SatellogicClient
import os

client = SatellogicClient(
    username=os.environ.get('SATLOGIC_USER', ''),
    password=os.environ.get('SATLOGIC_PASS', '')
)
catalog = client.catalog()
print(catalog)