{"id":28243,"library":"spotler-sdk","title":"Spotler SDK","description":"Python SDK for the Spotler email marketing platform. Current version 0.3.2, requires Python >=3.12 and <4.0. Early-stage package with infrequent releases.","status":"active","version":"0.3.2","language":"python","source_language":"en","source_url":"https://github.com/spotler/spotler-sdk-python","tags":["spotler","email","sdk","marketing"],"install":[{"cmd":"pip install spotler-sdk","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP client library used by the SDK","package":"httpx","optional":false},{"reason":"Data validation and settings management","package":"pydantic","optional":false}],"imports":[{"note":"Underscore in package name; common mistake to omit it.","wrong":"from spotler import SpotlerClient","symbol":"SpotlerClient","correct":"from spotler_sdk import SpotlerClient"},{"note":"Models are in a separate submodule.","wrong":"import Mailing from spotler_sdk","symbol":"Mailing","correct":"from spotler_sdk.models import Mailing"}],"quickstart":{"code":"from spotler_sdk import SpotlerClient\n\nclient = SpotlerClient(\n    base_url='https://api.spotler.com',\n    api_key=os.environ.get('SPOTLER_API_KEY', '')\n)\ntry:\n    mailings = client.mailings.list()\n    print(mailings)\nexcept Exception as e:\n    print(f'Error: {e}')","lang":"python","description":"Initialize client with API key and list mailings."},"warnings":[{"fix":"Use `from spotler_sdk import ...`.","message":"The package name on PyPI is 'spotler-sdk' but the import module uses underscore: 'spotler_sdk'.","severity":"gotcha","affected_versions":"all"},{"fix":"Pin exact version in requirements: spotler-sdk==0.3.2","message":"No deprecation warnings known; however, the SDK is very early (v0.3.2) and breaking changes may occur without notice.","severity":"deprecated","affected_versions":"<1.0.0"},{"fix":"Upgrade Python to >=3.12.","message":"Python 3.12 minimum required; cannot install on Python 3.11 or earlier.","severity":"breaking","affected_versions":"0.3.2"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use `from spotler_sdk import SpotlerClient`.","cause":"Incorrect import path: 'spotler' instead of 'spotler_sdk'.","error":"ModuleNotFoundError: No module named 'spotler'"},{"fix":"Ensure SPOTLER_API_KEY environment variable is set correctly, or pass api_key directly.","cause":"The API key provided to SpotlerClient is incorrect or missing.","error":"spotler_sdk.exceptions.AuthenticationError: Invalid API Key"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}