Metadata-Version: 2.4
Name: pangolinfo-niche-data
Version: 0.1.0
Summary: Pangolinfo Niche Data API - Amazon category tree, niche filtering, Best Sellers and New Releases.
Project-URL: Homepage, https://www.pangolinfo.com/amazon-niche-data-api/
Project-URL: Documentation, https://docs.pangolinfo.com
Project-URL: Repository, https://github.com/Pangolin-spg/pangolinfo-niche-data
Project-URL: Changelog, https://github.com/Pangolin-spg/pangolinfo-niche-data/releases
Project-URL: Issues, https://github.com/Pangolin-spg/pangolinfo-niche-data/issues
Project-URL: Free API Key, https://tool.pangolinfo.com
Author-email: "PANGOLIN INFO TECH PTE. LTD." <support@pangolinfo.com>
License-Expression: MIT
License-File: LICENSE
Keywords: amazon,api,bestsellers,category,niche,pangolinfo,product-research,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: httpx>=0.24
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: respx>=0.20; extra == 'dev'
Requires-Dist: twine>=4.0; extra == 'dev'
Description-Content-Type: text/markdown

# pangolinfo-niche-data

Pangolinfo Niche Data API - Amazon category tree, niche filtering, Best Sellers and New Releases.

> Built and maintained by [PANGOLIN INFO TECH PTE. LTD.](https://www.pangolinfo.com)

## Installation

```
pip install pangolinfo-niche-data
```

## Quick start

```python
from pangolinfo_niche_data import NicheDataClient

client = NicheDataClient(token="your_bearer_token")
result = client.get_category_tree()
print(result)
```

## Methods

| Method | Description |
|---|---|
| `client.get_category_tree(...)` | Get the root Amazon category tree |
| `client.get_category_children(...)` | Get child nodes of a browse node |
| `client.search_categories(...)` | Full-text search across category names |
| `client.batch_category_paths(...)` | Batch-query full paths for category IDs |
| `client.filter_categories(...)` | Filter categories by multi-dimensional metrics |
| `client.filter_niches(...)` | Discover blue-ocean niches by competition/demand |
| `client.list_bestsellers(...)` | List Best Sellers for a category |
| `client.list_new_releases(...)` | List New Releases for a category |

## Links

- **Product page:** [https://www.pangolinfo.com/amazon-niche-data-api/](https://www.pangolinfo.com/amazon-niche-data-api/)
- **Documentation:** [docs.pangolinfo.com](https://docs.pangolinfo.com)
- **Get a free API key:** [tool.pangolinfo.com](https://tool.pangolinfo.com)
- **Source code:** [github.com/Pangolin-spg/pangolinfo-niche-data](https://github.com/Pangolin-spg/pangolinfo-niche-data)

## License

MIT — © PANGOLIN INFO TECH PTE. LTD.
