Skip to content

Releases: shopsavvy/sdk-python

🚀 ShopSavvy Python SDK v1.0.2 - Enhanced Documentation

30 Jul 07:52

Choose a tag to compare

🚀 ShopSavvy Python SDK v1.0.2 - Enhanced Documentation

This release features a completely enhanced README with comprehensive examples, use cases, and production-ready code samples!

✨ What's New

📚 Comprehensive Documentation

  • 30-second quick start example with instant results
  • Feature comparison table with real-world use cases
  • Complete API reference with all methods and parameters
  • Production deployment examples (Docker, AWS Lambda)
  • Testing and development setup instructions

🛠️ Advanced Usage Examples

  • 🏆 Price Comparison Tool - Find best deals across retailers with savings calculation
  • 🚨 Smart Price Alert System - Automated monitoring with custom alerts
  • 📊 Market Analysis Dashboard - Comprehensive trend analysis with statistics
  • 🔄 Bulk Product Management - CSV-based product processing workflows
  • 🌐 Multi-Format Data Export - JSON and CSV export capabilities

🔧 Best Practices & Production Examples

  • Error handling with comprehensive exception management
  • Rate limiting decorators for API call management
  • Configuration management with environment variables
  • Retry logic with exponential backoff
  • Production deployment templates

🌟 Real-World Integration Examples

  • E-commerce Platform Integration - Competitive pricing analysis
  • Business Intelligence Dashboard - Market insights and reporting
  • Mobile App Backend - Flask API for barcode scanning

📱 Developer Experience Improvements

  • Professional formatting with emojis and tables
  • Step-by-step code examples with explanations
  • Copy-paste ready code snippets
  • Comprehensive error handling examples
  • Production-ready deployment configurations

📦 Installation

pip install shopsavvy-sdk

🚀 Quick Start

from shopsavvy import create_client

# Initialize the client
api = create_client("ss_live_your_api_key_here")

# Look up any product by barcode, ASIN, or URL
product = api.get_product_details("012345678901")
print(f"📦 {product.data.name} by {product.data.brand}")

# Get current prices from all retailers
offers = api.get_current_offers("012345678901")
cheapest = min(offers.data, key=lambda x: x.price)
print(f"💰 Best price: ${cheapest.price} at {cheapest.retailer}")

# Set up price monitoring
api.schedule_product_monitoring("012345678901", "daily")
print("🔔 Price alerts activated\!")

🔗 Links

🛠️ What's Changed

  • Enhanced README with 1000+ lines of comprehensive documentation
  • Added advanced usage examples with real-world scenarios
  • Included production deployment templates and best practices
  • Added comprehensive error handling and rate limiting examples
  • Enhanced API reference with all methods and parameters
  • Added real-world integration examples for various platforms

📈 Developer Impact

This release transforms the ShopSavvy Python SDK from a basic library into a comprehensive development platform with:

  • Faster onboarding with 30-second quick start
  • 🛠️ Production-ready code examples and templates
  • 📚 Complete documentation eliminating guesswork
  • 🔧 Best practices for error handling and deployment
  • 🌟 Real-world examples for immediate implementation

🎯 Perfect for: E-commerce platforms, price comparison tools, market research applications, mobile apps, business intelligence dashboards, and any application requiring product data and pricing intelligence.

💬 Need help? Contact us at business@shopsavvy.com or visit shopsavvy.com/data

ShopSavvy Python SDK v1.0.1

30 Jul 07:41

Choose a tag to compare

🚀 ShopSavvy Python SDK v1.0.1

This is the initial public release of the official Python SDK for the ShopSavvy Data API.

✨ Features

  • Product Lookup: Search by barcode, ASIN, URL, or model number
  • Current Pricing: Get real-time prices from all major retailers
  • Price History: Access historical pricing data and trends
  • Product Monitoring: Schedule automated price tracking
  • Usage Analytics: Track API usage and credits
  • Type Safety: Full type annotations with Pydantic models
  • Error Handling: Comprehensive exception handling for all scenarios
  • Context Managers: Support for automatic connection cleanup

📦 Installation

```bash
pip install shopsavvy-sdk
```

🔧 Quick Start

```python
from shopsavvy import create_client

Initialize the client

api = create_client("ss_live_your_api_key_here")

Look up a product by barcode

product = api.get_product_details("012345678901")
print(product.data.name)

Get current prices from all retailers

offers = api.get_current_offers("012345678901")
for offer in offers.data:
print(f"{offer.retailer}: ${offer.price}")
```

🔗 Links

🛠️ Changes in v1.0.1

  • Fixed package name from `shopsavvy-data-api` to `shopsavvy-sdk` to match PyPI publication
  • Updated all installation instructions and examples in README
  • Added comprehensive documentation with examples and best practices

Need help? Contact us at business@shopsavvy.com or visit shopsavvy.com/data