Metadata-Version: 2.1
Name: pricepulse
Version: 0.1.0
Summary: Python client for PricePulse - real-time price monitoring API
Home-page: https://github.com/rock2089/pricepulse-api
Author: PricePulse Team
Author-email: zhu.shisong@163.com
License: UNKNOWN
Keywords: price monitoring ecommerce carousell amazon singapore arbitrage
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.25.0)

# PricePulse Python SDK

A Python client for [PricePulse](https://incl-coupons-question-pair.trycloudflare.com) - real-time price monitoring API for Southeast Asian e-commerce.

## Installation

```bash
pip install pricepulse
```

## Quick Start

```python
from pricepulse import PricePulse

# Get your free API key at https://pricepulse.dev
client = PricePulse(api_key="your-key-here")

# Search products
results = client.search("iPhone 15", source="carousell")
for p in results:
    print(f"{p['title']} - ${p['price']}")

# Check trending
trending = client.trending()

# Find arbitrage
deals = client.arbitrage(min_profit=20)
```

## API Reference

| Method | Description |
|--------|-------------|
| `search(query, source, limit)` | Search products |
| `trending(source, limit)` | Get trending |
| `arbitrage(min_profit, limit)` | Find arbitrage |
| `categories(source)` | Browse categories |
| `health()` | Health check |

Get your free API key at [PricePulse](https://incl-coupons-question-pair.trycloudflare.com/pricing)


