Metadata-Version: 2.3
Name: creators
Version: 0.2.0
Summary: Amazon Creators API wrapper for Python
Keywords: amazon,creators,api,sdk,wrapper
Author: Song
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: pydantic>=2
Requires-Dist: python-dateutil>=2.5.3
Requires-Dist: requests>=2.25.0
Requires-Dist: setuptools>=21.0.0
Requires-Dist: typing-extensions>=4.7.1
Requires-Dist: urllib3>2.1.0
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/songron/creators
Project-URL: Issues, https://github.com/songron/creators/issues
Project-URL: Repository, https://github.com/songron/creators
Description-Content-Type: text/markdown

# Amazon Creators API

This is a small wrapper around the official Amazon Creators API Python SDK. It provides a lightweight package entry point while directly exposing the SDK's models and exceptions.

## Install

### pip

```bash
pip install creators
```

### uv

```bash
uv add creators
```

## Usage

```python
from creators import Client, SearchItemsResource, GetItemsResource, ApiException

client = Client(
    credential_id="YOUR_CREDENTIAL_ID",
    credential_secret="YOUR_CREDENTIAL_SECRET",
    version="3.1",
    marketplace="www.amazon.com",
    partner_tag="yourtag-20",
)

try:
    response = client.search_items(
        keywords="wireless earbuds",
        item_count=5,
        resources=[SearchItemsResource.ITEM_INFO_DOT_TITLE],
    )
    print(response.search_result.items)
except ApiException as exc:
    print(f"api error: {exc}")

try:
    response = client.get_items(
        item_ids=["B000123456", "B000987654"],
        resources=[GetItemsResource.ITEM_INFO_DOT_TITLE],
    )
    print(response.items_result.items)
except ApiException as exc:
    print(f"api error: {exc}")
```

## Notes

- Models are re-exported from the official SDK.
- Exceptions are re-exported from the official SDK.
- More examples are available in `examples/`.
- To run tests or the examples, install dev dependencies first with `uv sync --group dev`, then run `pytest` or the scripts in `examples/`.

## References

- [Creators API Docs](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/introduction)
- [Available SDKs](https://affiliate-program.amazon.com/creatorsapi/docs/en-us/get-started/using-sdk)
- License: MIT (see `LICENSE`).
