# ShopSavvy — Complete Content
> This file contains the full content of all ShopSavvy product and documentation pages in markdown format.
> For individual pages, append .md to any URL (e.g., https://shopsavvy.com/agents.md).
> For the navigation index, see https://shopsavvy.com/llms.txt
---
# ShopSavvy for AI Agents - MCP Server & Skills
> Connect your AI assistant to ShopSavvy's database of 100M+ products. Works with Claude, Claude Code, ChatGPT, Codex, Gemini, and any MCP-compatible agent. Free to use.
*Source: https://shopsavvy.com/agents*
---
## Hero
**Badge:** Agent Skills & MCP Server
**Headline:** Shop Smarter with Any AI Agent
**Subheadline:** Connect your favorite AI assistant to ShopSavvy's database of 100M+ products. Get instant price comparisons from 40,000+ retailers in any conversation.
**Trust Indicators:**
- No signup required
- 100% free to use
- 100M+ products
- 40,000+ retailers
---
## Supported Agents
### Primary AI Assistants
Works with leading AI assistants:
| Agent | Provider |
|-------|----------|
| Claude Desktop | Anthropic |
| Claude Code | Anthropic |
| ChatGPT | OpenAI |
| Codex | OpenAI |
| Gemini | Google |
| Copilot | GitHub |
### AI-Powered IDEs & Editors
Plus AI-powered IDEs & editors:
| IDE/Editor | Provider |
|------------|----------|
| Cursor | AI-first IDE |
| Windsurf | Codeium |
| VS Code | Microsoft |
| JetBrains | IntelliJ & more |
| Zed | Fast editor |
| Continue | Open source |
---
## How It Works
Three simple steps to smarter shopping with any AI:
### Step 1: Connect the MCP Server
Add ShopSavvy to your AI agent using our MCP server URL or install the skill/plugin.
### Step 2: Ask About Products
Just ask naturally! "What's the best price for AirPods Pro?" or "Compare prices for this TV."
### Step 3: Get Instant Answers
Your AI searches our database of 100M+ products and shows you the best prices from 40,000+ stores.
---
## Research Workflows (What You Can Ask)
Four common research workflows your AI can help with:
### Find Best Price
- **Query:** "What's the best price for AirPods Pro?"
- **Tools used:** `product_lookup`, `product_offers`
- **Result:** Current prices from all retailers with deal assessment
### Research a Category
- **Query:** "Best gaming laptops under $1500"
- **Tools used:** `content_best_picks`, `universal_search`
- **Result:** Top picks with expert reviews and current prices
### Timing Advice
- **Query:** "Is now a good time to buy a TV?"
- **Tools used:** `product_price_history`, `content_buying_guide`
- **Result:** Price trends and when-to-buy recommendations
### Compare Products
- **Query:** "Compare iPhone 15 vs Samsung S24"
- **Tools used:** `product_lookup_batch`, `content_tldr_review`
- **Result:** Side-by-side specs, prices, and pros/cons
---
## Features (What Your AI Can Do)
Powerful shopping tools available through any connected AI agent:
### Find the Best Price
Search any product and instantly see prices from thousands of retailers. Never overpay again.
### Check Price History
See how prices have changed over time. Know if you're getting a good deal or if you should wait.
### Get Buy/Wait Advice
Find out if a product is at a good price now or if you should wait for a better deal. Timing matters.
### Research Any Product
Look up products by name, barcode, URL, or model number. Your AI finds it all.
### Expert Buying Guides
Access curated "Best Of" articles, TLDR reviews with pros/cons, and when-to-buy timing advice.
### Smart Recommendations
Get AI-powered product recommendations based on rankings, reviews, and price analysis.
---
## Example Conversations
See how AI agents help you shop smarter:
### Conversation 1: Best Price Lookup
**You:** What's the best price for AirPods Pro right now?
**AI Assistant:** I found AirPods Pro 2nd Gen at several retailers. The best price is $189.99 at Amazon (normally $249). This is $10 above the all-time low of $179.99 from Black Friday. Good deal if you need them now!
### Conversation 2: Buy or Wait
**You:** Is this a good time to buy a PS5?
**AI Assistant:** Based on price history, PS5 prices are currently stable at $449. The best prices typically appear during Black Friday ($349-$399) and occasionally during major sales. If you can wait, I'd suggest holding off until the next major shopping event.
### Conversation 3: Price Comparison
**You:** Compare prices for the Samsung S24 Ultra
**AI Assistant:** Samsung S24 Ultra (256GB) prices:
- Samsung.com: $1,299 (with trade-in: $799)
- Amazon: $1,199
- Best Buy: $1,199 (plus $100 gift card)
- Walmart: $1,199
Best value: Best Buy with the gift card bonus.
### Conversation 4: Best Picks
**You:** What are the best wireless earbuds right now?
**AI Assistant:** Based on expert reviews and current prices, here are the top picks:
1. AirPods Pro 2 - Best for iPhone ($189 at Amazon)
2. Sony WF-1000XM5 - Best sound quality ($248 at Best Buy)
3. Samsung Galaxy Buds 3 Pro - Best for Android ($179 at Samsung)
All three have excellent noise cancellation. The AirPods Pro 2 are at a great price right now, down from $249.
### Conversation 5: Product Reviews
**You:** What are people saying about the Sony WH-1000XM5?
**AI Assistant:** The Sony WH-1000XM5 headphones get excellent reviews:
Pros:
- Best-in-class noise cancellation
- Exceptional 30-hour battery life
- Very comfortable for long sessions
- Great call quality
Cons:
- No folding design (less portable)
- Premium price point
Bottom line: The best overall noise-canceling headphones for most people.
### Conversation 6: Sale Timing
**You:** When do TVs usually go on sale?
**AI Assistant:** TVs have predictable sale cycles:
Best times to buy:
- Super Bowl (late Jan/early Feb) - 15-25% off
- Amazon Prime Day (July) - 20-30% off
- Black Friday (November) - 25-40% off
Pro tip: New TV models release in spring, so last year's models drop significantly in March-April. Consider previous-year models for the best value.
---
## Pricing
### Free for Everyone
Generous limits for casual use, more power for heavy users.
### Free Tier - $0
No signup required.
- 10 requests per minute
- 100 requests per hour
- All tools included
- Perfect for casual shopping
### Premium Tier - $49/mo
Data API subscription. For Power Users.
- 100 requests per minute
- No hourly limit
- Priority support
- For developers & power users
View Data API plans at https://shopsavvy.com/data
---
## Installation Guide
Select your AI platform for step-by-step setup instructions.
### Quick Install (One Command)
No signup required. Works immediately.
**Claude Code:**
```
claude mcp add --transport sse shopsavvy https://api.shopsavvy.com/mcp/sse
```
**Any MCP Agent (NPX):**
```
npx shopsavvy-mcp
```
npm package: https://www.npmjs.com/package/shopsavvy-mcp
**Direct SSE URL:**
```
https://api.shopsavvy.com/mcp/sse
```
Or scroll down for detailed setup instructions for your specific platform.
### Or Just Tell Your AI
If you're using Claude Code, you can simply ask Claude to install it:
> "Please install the ShopSavvy MCP server so I can research product prices"
Claude will run the install command for you automatically.
---
### Claude Desktop Setup
**Step 1: Open your config file**
Find and open your Claude Desktop configuration file:
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux:** `~/.config/Claude/claude_desktop_config.json`
**Step 2: Add ShopSavvy server**
Add this configuration (create the file if it doesn't exist):
```json
{
"mcpServers": {
"shopsavvy": {
"command": "npx",
"args": ["shopsavvy-mcp"]
}
}
}
```
**Step 3: Restart Claude Desktop**
Completely quit and reopen Claude Desktop. Look for the MCP indicator in the bottom-right corner of the chat input.
**Note:** Requires Node.js to be installed. The `shopsavvy-mcp` package auto-downloads on first run via npx.
---
### Claude Code Setup
**One-Command Install**
Run this command in your terminal:
```
claude mcp add --transport sse shopsavvy https://api.shopsavvy.com/mcp/sse
```
**Verify Installation**
Check that ShopSavvy is connected:
```
claude mcp list
```
Or type `/mcp` in Claude Code to see connection status.
**Scopes:** Add `--scope user` to make it available across all projects, or `--scope project` to share via `.mcp.json` with your team.
---
### ChatGPT Setup
**Requires:** ChatGPT Desktop app with Developer Mode enabled (added March 2025)
**Step 1: Enable Developer Mode**
In ChatGPT Desktop, go to **Settings > Connectors > Advanced** and enable **Developer Mode**.
**Step 2: Add MCP Connector**
Add a new MCP connector with the ShopSavvy server URL:
```
https://api.shopsavvy.com/mcp/sse
```
**Step 3: Start Using**
ChatGPT will now have access to ShopSavvy tools. Ask about products and prices naturally!
---
### OpenAI Codex Setup
**One-Command Install**
Run this in your terminal:
```
codex mcp add shopsavvy -- npx shopsavvy-mcp
```
**Or configure manually**
Add to your `~/.codex/config.toml`:
```toml
[mcp_servers.shopsavvy]
command = "npx"
args = ["-y", "mcp-remote", "https://api.shopsavvy.com/mcp/sse"]
```
---
### Google Gemini Setup
**Step 1: Open settings file**
Edit `~/.gemini/settings.json`:
**Step 2: Add ShopSavvy**
```json
{
"mcpServers": {
"shopsavvy": {
"command": "npx",
"args": ["shopsavvy-mcp"]
}
}
}
```
**Step 3: Restart Gemini**
Restart Gemini CLI or your Gemini-powered application.
---
### Cursor IDE Setup
**Step 1: Open MCP settings**
Press `Ctrl + Shift + P` (or `Cmd + Shift + P` on Mac), type "cursor settings", and find the MCP option in the sidebar.
**Step 2: Add configuration**
Or edit `~/.cursor/mcp.json` directly:
```json
{
"mcpServers": {
"shopsavvy": {
"command": "npx",
"args": ["shopsavvy-mcp"]
}
}
}
```
**Step 3: Restart Cursor**
Restart Cursor to activate the MCP server.
---
### VS Code / GitHub Copilot Setup
**Requires:** VS Code 1.99+ with GitHub Copilot. MCP is GA in VS Code 1.102+.
**Step 1: Open settings**
Go to **Settings > Extensions > GitHub Copilot > MCP Servers**, or edit your `settings.json`.
**Step 2: Add MCP server**
```json
"github.copilot.chat.mcpServers": {
"shopsavvy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.shopsavvy.com/mcp/sse"]
}
}
```
**Step 3: Use in Agent Mode**
Enable Copilot Agent Mode to use MCP tools. ShopSavvy tools will be available in your Copilot chat.
---
### Windsurf IDE Setup
**Step 1: Open config file**
Edit your Windsurf MCP configuration:
- **macOS:** `~/.codeium/windsurf/mcp_config.json`
- **Windows:** `%USERPROFILE%\.codeium\windsurf\mcp_config.json`
**Step 2: Add configuration**
```json
{
"mcpServers": {
"shopsavvy": {
"command": "npx",
"args": ["shopsavvy-mcp"]
}
}
}
```
**Or use the MCP Marketplace**
Go to **Settings > Cascade > MCP Servers** to browse and add servers.
---
## Available Tools
Once connected, your AI will have access to these shopping tools:
### Product Research
| Tool | Description |
|------|-------------|
| `product_lookup` | Find by barcode, ASIN, or URL |
| `product_search` | Search by keyword |
| `universal_search` | Enhanced search with rankings |
### Price Intelligence
| Tool | Description |
|------|-------------|
| `product_offers` | Prices from all retailers |
| `product_price_history` | Historical pricing trends |
| `product_schedule` | Set up price alerts |
### Expert Content
| Tool | Description |
|------|-------------|
| `content_best_picks` | Curated buying guides |
| `content_tldr_review` | Quick pros/cons verdicts |
| `content_qa_answers` | Product Q&A answers |
| `content_buying_guide` | When-to-buy timing advice |
---
## Other MCP-Compatible Platforms
ShopSavvy works with any platform that supports the Model Context Protocol, including:
- Continue.dev
- JetBrains IDEs
- Sourcegraph Cody
- Zed Editor
- Cline
- LibreChat
- MindPal
- Chainlit
For these platforms, use the MCP Server URL above and follow their documentation for adding SSE-based MCP servers.
---
## Frequently Asked Questions
### Which AI platforms are supported?
ShopSavvy works with any platform supporting the Model Context Protocol (MCP). This includes Claude Desktop, Claude Code, ChatGPT (with Developer Mode), OpenAI Codex, Google Gemini, GitHub Copilot, Cursor, Windsurf, VS Code, JetBrains IDEs, Zed, Continue.dev, and many more. MCP has become the standard for AI tool integrations, with 17,000+ community servers and widespread adoption.
### Do I need Node.js installed?
For most platforms, yes. Node.js is required to run the mcp-remote bridge that connects our SSE server to your AI tool. Claude Code is the exception since it has native SSE support and can connect directly without extra dependencies.
### Do I need a ShopSavvy account?
Nope! The MCP server works immediately without any signup. Just connect using the server URL and start asking about products. Anonymous users get generous rate limits.
### Is it really free?
Yes! The free tier includes 10 requests per minute and 100 requests per hour, which is plenty for most users. No credit card or account required. We believe everyone should have access to price comparison tools.
### What can I ask my AI about?
Anything about shopping! Ask for price comparisons across retailers, check if now is a good time to buy, view price history trends, look up products by barcode/URL/ASIN, set up price alerts, and get deal recommendations. Your AI will search our database of 100M+ products to help you.
### How do I get higher rate limits?
Power users and developers can subscribe to our Data API starting at $49/month. This gives you 100 requests per minute with no hourly limit, plus priority support. Visit our Data API page for all plans.
### Which retailers do you track?
Over 40,000 retailers including Amazon, Walmart, Best Buy, Target, eBay, Costco, Home Depot, Newegg, B&H Photo, and thousands more. If it's a major retailer in the US, we almost certainly track it.
### What is MCP?
The Model Context Protocol (MCP) is an open standard developed by Anthropic that lets AI assistants connect to external tools and data sources. It was donated to the Linux Foundation in December 2025 and has been adopted by major platforms including OpenAI, Google, GitHub, and many AI-powered IDEs.
---
## Call to Action
**Ready to Shop Smarter?**
Connect your favorite AI agent to ShopSavvy and start finding better deals.
Get Started Free at https://shopsavvy.com/agents#install
---
# ShopSavvy Data API
> Product & Pricing Data for Developers
*Source: https://shopsavvy.com/data*
---
## Hero
**ShopSavvy Data API**
Use our powerful HTTP API to access or track product details, pricing and availability data, historical data and more on millions of products and billions of prices across tens of thousands of retailers and sellers.
- [Get Started](#pricing)
- [Read Documentation](/data/documentation)
- [API Dashboard](/data/dashboard)
---
## Consumer Callout
**Not a developer?**
Use ShopSavvy with Claude, ChatGPT, Gemini & other AI assistants. No coding required! [Connect Your AI](/agents)
---
## The Power of ShopSavvy, Anywhere
**Advanced Retail Intelligence**
Product details, prices, availability, deals, expert reviews, scheduled refreshes, historical data, and more. It's all here and ready to integrate into your app, product, service, or workflow.
### Product Details
Lookup and identify products using tons of different supported identifiers like barcode, ASIN, and more. Get comprehensive data including specifications, ratings, review summaries, pricing, and more for millions of products.
### All Prices at All Retailers
Built upon our years of experience in e-commerce, our API can provide high accuracy, high fidelity, and comprehensive data about the price and availability of products across tens of thousands of retailers and millions of sellers.
### Deals & Expert Reviews
Access our curated deals feed with expert grades (A+ through F), community votes, and TLDR product reviews with pros, cons, bottom line verdicts, and quantitative scores. Great for building deal discovery and product recommendation features.
### Price History & Scheduled Refreshes
Track every price and availability change over time. Schedule products for automatic refreshes on your chosen cadence — hourly, daily, or weekly. All data available in JSON or CSV.
---
## Packed with Features
**Everything You Need**
We try to support as many different use cases as possible. If you need functionality we don't offer yet, please let us know at business@shopsavvy.com.
### Barcode Lookup
Identify products by their barcode. We support UPC, EAN, and ISBN and more, and have high-quality data about millions of products.
### URL Lookup
Our API can identify products by their URL at any retailer, just use the URL as the identifier when looking up products or offers.
### Amazon ASIN Lookup
We fully support retrieving product details, offers, and more using Amazon ASINs.
### CSV Support
All responses support JSON, but product details and offers can (optionally) be returned in CSV format. We even flatten out the data so it can be easily imported into a spreadsheet or other system.
### Model & MPN Lookup
Some partners only have model numbers or MPNs for products. Our API also supports looking up products by these kinds of identifiers.
### Multiple Product Lookups
Retrieving product details, offers, updating refresh schedules and more can all be done for multiple products at once using a simple comma-separated list of identifiers.
### First Party Retailers & Third Party Sellers
Our price and availability data covers tens of thousands of retailers and millions of sellers. We track and make sense of all of them to provide you with the most accurate and comprehensive data possible.
### Useful Metadata
Much more than just prices. Offers retrieved through the API also provide a URL, product condition, and more for every single retailer or seller selling the product.
---
## Quick Examples
**See It In Action**
Simple, Straightforward API Calls
Get product and pricing data with simple individual API calls.
### Get Product Details
Look up products by barcode (UPC, EAN, ISBN), ASIN, URL, model number, or MPN
**Request:**
```bash
curl -X GET 'https://api.shopsavvy.com/v1/products?barcode=012345678901' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
**Response:**
```json
{
"product": {
"name": "Apple iPhone 15 Pro Max",
"brand": "Apple",
"category": "Electronics",
"images": [...],
"identifiers": {
"asin": "B0CHX3TW6K",
"upc": "195949038341"
}
}
}
```
**Cost:** 1 credit
### Get All Retailer Prices
Get current prices and availability from 70,000+ retailers and sellers
**Request:**
```bash
curl -X GET 'https://api.shopsavvy.com/v1/offers?asin=B0CHX3TW6K' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
**Response:**
```json
{
"offers": [
{
"retailer": "Amazon",
"price": 999.00,
"availability": "in_stock",
"url": "https://amazon.com/...",
"condition": "new"
},
{
"retailer": "Best Buy",
"price": 999.99,
"availability": "in_stock",
"url": "https://bestbuy.com/...",
"condition": "new"
}
// ... 70,000+ retailers
]
}
```
**Cost:** 3 credits
### Track Price History
Get historical pricing and availability changes with timestamps for any date range
**Request:**
```bash
curl -X GET 'https://api.shopsavvy.com/v1/offers?asin=B0CHX3TW6K&history_days=30' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
**Response:**
```json
{
"offers": [
{
"retailer": "Amazon",
"current_price": 999.00,
"availability": "in_stock",
"history": [
{
"price": 1199.00,
"availability": "in_stock",
"timestamp": "2025-10-01T00:00:00Z"
},
{
"price": 999.00,
"availability": "in_stock",
"timestamp": "2025-10-15T14:30:00Z"
}
]
}
]
}
```
**Cost:** 3 credits + 1 per day
### Other Available Endpoints
Plus many more capabilities to fit your needs:
- Search Products by Keyword
- Schedule Automatic Price Monitoring
- Get Single Retailer Offers
- Export Data in CSV Format
- Batch Product Lookups
- View Usage Statistics
---
## MCP Server
**For AI Assistants**
### Model Context Protocol Server
Connect Claude Desktop and other AI assistants directly to ShopSavvy's product database with our open-source MCP server. Get instant access to product lookups, pricing data, and price history right in your AI conversations.
#### AI Assistant Integration
Works with Claude Desktop, Cursor, and any MCP-compatible AI assistant
#### Open Source
MIT licensed and available on GitHub for customization and contributions
#### Easy Setup
Install with npm and configure in minutes with your API key
- [View on GitHub](https://github.com/shopsavvy/shopsavvy-mcp-server)
- [Installation Guide](/data/documentation#mcp-server)
---
## Pricing
**Straightforward, Fair, Competitive Pricing**
Choose a plan below to get started. Once subscribed in our developer portal, you'll be given a Base URL and API Key. You'll use these to access the API. [Read the documentation](/data/documentation) for complete instructions.
### Starter — $49/month
*Perfect for small projects*
1,000 credits/month
- 14-day free trial
- 1,000 API credits per month
- All API endpoints included
- JSON and CSV responses
- Usage analytics dashboard
- Email support
### Professional — $199/month *(Most Popular)*
*For growing businesses*
10,000 credits/month
- 10,000 API credits per month
- All API endpoints included
- JSON and CSV responses
- Usage analytics dashboard
- Priority email support
### Enterprise — $499/month
*High-volume usage*
50,000 credits/month
- 50,000 API credits per month
- All API endpoints included
- JSON and CSV responses
- Usage analytics dashboard
- Priority support
### Custom — Custom Pricing
*For enterprise teams with custom requirements*
Unlimited API credits
**Need more than 50,000 credits?**
**Custom plan features:**
- Custom credit limits
- Volume discounts
- Dedicated support
- Custom SLAs
- Premium support channels
- Custom contract terms
**Perfect for:** Large enterprises, high-volume integrations, and teams requiring dedicated support
[Contact Sales](mailto:business@shopsavvy.com)
---
## How Credits Work
Retrieving different kinds of data from the API costs different amounts of credits. Details are listed below, as well as in the [documentation](/data/documentation).
| Action | Cost |
|--------|------|
| Retrieving Product Details | **1 credit** per product requested |
| Retrieving Offers for Products | **3 credits** for all retailers, **2 credits** for a single retailer |
| Retrieving Offers With Historical Offer Data | **3 credits** for all retailers, **2 credits** for a single retailer + **1 credit** for each day requested |
| Enabling or Changing Refresh Schedule for Products | **1 credit** per product scheduled or changed + **3 credits** every time each product is refreshed |
---
## CTA
**Ready to dive in?**
**Try the API today!**
- [Get started](#pricing)
- [Read Documentation](/data/documentation)
- [API Dashboard](/data/dashboard)
---
# ShopSavvy Data API - Documentation
> Complete developer guide for the ShopSavvy Data API
*Source: https://shopsavvy.com/data/documentation*
---
## Table of Contents
- [Getting Started](#getting-started)
- [Overview & Authentication](#overview--authentication)
- [Quick Start Guide](#quick-start-guide)
- [Pricing & Credits](#pricing--credits)
- [SDKs & Libraries](#sdks--libraries)
- [TypeScript/JavaScript](#typescriptjavascript-sdk)
- [Python](#python-sdk)
- [Ruby](#ruby-sdk)
- [Go](#go-sdk)
- [Java](#java-sdk)
- [PHP](#php-sdk)
- [C#](#c-sdk)
- [Rust](#rust-sdk)
- [Swift](#swift-sdk)
- [Kotlin](#kotlin-sdk)
- [SDK Comparison](#sdk-comparison)
- [AI Integration](#ai-integration)
- [Model Context Protocol Server](#model-context-protocol-server)
- [Claude Desktop Setup](#claude-desktop-setup)
- [Usage Examples](#usage-examples)
- [Products API](#products-api)
- [Retrieving Product Details](#retrieving-product-details)
- [Product Details in CSV Format](#retrieving-product-details-in-csv-format)
- [Searching Products by Keyword](#searching-products-by-keyword)
- [Batch API](#batch-api)
- [Batch Product Lookup](#batch-product-lookup)
- [Pricing API](#pricing-api)
- [Offers at All Retailers](#retrieving-offers-for-products-at-all-retailers)
- [Offers at a Single Retailer](#retrieving-offers-for-a-single-retailer)
- [Offers in CSV Format](#retrieving-offers-in-csv-format)
- [Price History](#retrieving-offers-with-historical-offer-data)
- [Scheduling API](#scheduling-api)
- [Schedule Monitoring](#enabling-scheduled-refreshes-for-products)
- [Update Schedule](#changing-refresh-schedule-for-products)
- [Remove Monitoring](#disabling-scheduled-refreshes-for-products)
- [View Scheduled Products](#retrieve-products-currently-enabled-for-scheduled-refreshes)
- [Deals API](#deals-api)
- [Browse Deals](#browse-deals)
- [Reviews API](#reviews-api)
- [Get TLDR Review](#get-tldr-review-for-product)
- [Webhooks](#webhooks)
- [Create Webhook](#create-webhook)
- [List Webhooks](#list-webhooks)
- [Test Webhook](#test-webhook)
- [Delete Webhook](#delete-webhook)
- [Analytics & Tools](#analytics--tools)
- [Usage Statistics](#get-api-usage-statistics)
- [CSV Request Builder](#csv-to-api-request-converter)
- [Rate Limits](#rate-limits)
---
## Getting Started
### Overview & Authentication
- First you'll need to [subscribe to one of our plans](https://shopsavvy.com/data#pricing).
- Once you've subscribed, you'll be redirected to your [Data API Dashboard](https://shopsavvy.com/data/dashboard).
- Go to [API Keys](https://shopsavvy.com/data/api-keys) to create and manage your API keys.
- Use your API keys to authenticate with the API.
**Base URL:** `https://api.shopsavvy.com/v1`
**Authentication:** Include your API key in the `Authorization` header as a Bearer token, or as an `api_key` query parameter.
**Authentication Examples:**
**Header (Recommended):**
```
Authorization: Bearer ss_live_abc123...
```
**Query Parameter:**
```
GET /v1/products?ids=123&api_key=ss_live_abc123...
```
That's it. You're now ready to start requesting data from the API.
### Quick Start Guide
Get up and running with the ShopSavvy Data API in minutes.
#### 1. Get Your API Key
1. Visit [shopsavvy.com/data](https://shopsavvy.com/data)
2. Sign up for an account
3. Choose a subscription plan
4. Get your API key from the dashboard
#### 2. Make Your First Request
Try looking up a product by barcode:
```bash
curl -X GET "https://api.shopsavvy.com/v1/products?ids=012345678901" \
-H "Authorization: Bearer ss_live_your_api_key_here"
```
#### 3. Use an SDK (Recommended)
For easier integration, use one of our official SDKs:
| Language | Install Command |
|----------|----------------|
| TypeScript/JavaScript | `npm install @shopsavvy/sdk` |
| Python | `pip install shopsavvy-sdk` |
| Ruby | `gem install shopsavvy-sdk` |
### Pricing & Credits
The ShopSavvy Data API uses a credit-based pricing system. Different operations cost different amounts of credits.
#### Credit Costs
| Operation | Cost |
|-----------|------|
| Retrieving Product Details | 1 credit per product |
| Searching Products by Keyword | 1 credit per product returned |
| Current Offers (All Retailers) | 3 credits per product |
| Current Offers (Single Retailer) | 2 credits per product |
| Price History | Offer cost + 1 credit per day |
| Schedule Product Monitoring | 1 credit + 3 credits per refresh |
| Browse Deals | 1 credit per 10 deals returned |
| TLDR Product Review | 1 credit per product |
| Batch Product Lookup | 1 credit per product found (+ 3 if including offers, + 1 if including reviews) |
#### Subscription Plans
Visit the [pricing page](https://shopsavvy.com/data#pricing) to see current subscription plans and credit allocations.
---
## SDKs & Libraries
### TypeScript/JavaScript SDK
Our official TypeScript/JavaScript SDK provides a convenient way to interact with the ShopSavvy Data API from Node.js and browser environments.
- [View on GitHub](https://github.com/shopsavvy/sdk-typescript)
- [View on npm](https://www.npmjs.com/package/@shopsavvy/sdk)
#### Installation
```bash
npm install @shopsavvy/sdk
# or
yarn add @shopsavvy/data-api
# or
bun add @shopsavvy/data-api
```
#### Basic Usage
```typescript
import { createShopSavvyClient } from '@shopsavvy/data-api'
// Initialize the client
const api = createShopSavvyClient({
apiKey: 'ss_live_your_api_key_here'
})
// Look up a product by barcode
const product = await api.getProductDetails('012345678901')
console.log(product.data.name)
// Get current prices from all retailers
const offers = await api.getCurrentOffers('012345678901')
offers.data.forEach(offer => {
console.log(`${offer.retailer}: $${offer.price}`)
})
// Get price history
const history = await api.getPriceHistory(
'012345678901',
'2024-01-01',
'2024-01-31'
)
```
#### Features
- Full TypeScript support with comprehensive type definitions
- Modern async/await API
- Automatic error handling and retry logic
- Support for both Node.js and browser environments
- Built-in request/response validation
- Comprehensive documentation and examples
#### Error Handling
```typescript
try {
const product = await api.getProductDetails('invalid-identifier')
} catch (error) {
if (error.message.includes('Product not found')) {
console.log('Product does not exist')
} else if (error.message.includes('Invalid API key')) {
console.log('Check your API key')
} else {
console.log('Unexpected error:', error.message)
}
}
```
### Python SDK
Our official Python SDK provides a convenient way to interact with the ShopSavvy Data API from Python applications with full type safety and modern async support.
- [View on GitHub](https://github.com/shopsavvy/sdk-python)
- [View on PyPI](https://pypi.org/project/shopsavvy-sdk/)
#### Installation
```bash
pip install shopsavvy-data-api
```
#### Basic Usage
```python
from shopsavvy import create_client
# Initialize the client
client = create_client("ss_live_your_api_key_here")
# Look up a product by barcode
product = client.get_product_details("012345678901")
print(product.data.name)
# Get current prices from all retailers
offers = client.get_current_offers("012345678901")
for offer in offers.data:
print(f"{offer.retailer}: {offer.price}")
# Get price history
history = client.get_price_history(
"012345678901",
"2024-01-01",
"2024-01-31"
)
```
#### Features
- Full type safety with Pydantic models
- Modern HTTP client with automatic retries
- Comprehensive error handling
- Rails integration support
- Context manager support for automatic cleanup
- Python 2.7+ compatibility
#### Context Manager Usage
```python
with create_client("ss_live_your_api_key_here") as client:
product = client.get_product_details("012345678901")
print(product.data.name)
# Client automatically closed
```
#### Error Handling
```python
from shopsavvy import create_client, NotFoundError, AuthenticationError
try:
client = create_client("ss_live_your_api_key_here")
product = client.get_product_details("invalid-identifier")
except NotFoundError:
print("Product not found")
except AuthenticationError:
print("Invalid API key")
except Exception as e:
print(f"Unexpected error: {e}")
```
### Ruby SDK
Our official Ruby SDK provides a convenient way to interact with the ShopSavvy Data API from Ruby applications with idiomatic Ruby patterns and comprehensive documentation.
- [View on GitHub](https://github.com/shopsavvy/sdk-ruby)
- [View on RubyGems](https://rubygems.org/gems/shopsavvy-sdk)
#### Installation
```bash
gem install shopsavvy-sdk
# Or add to your Gemfile:
gem 'shopsavvy-sdk'
```
#### Basic Usage
```ruby
require 'shopsavvy_data_api'
# Initialize the client
client = ShopsavvyDataApi.new(api_key: "ss_live_your_api_key_here")
# Look up a product by barcode
product = client.get_product_details("012345678901")
puts product.data.name
# Get current prices from all retailers
offers = client.get_current_offers("012345678901")
offers.data.each do |offer|
puts "#{offer.retailer}: $#{offer.price}"
end
# Get price history
history = client.get_price_history(
"012345678901",
"2024-01-01",
"2024-01-31"
)
```
#### Features
- Idiomatic Ruby patterns and conventions
- Comprehensive YARD documentation
- Automatic retry logic with exponential backoff
- Convenient model methods and helpers
- Rails integration examples
- Ruby 2.7+ compatibility
#### Rails Integration
```ruby
# config/initializers/shopsavvy.rb
Rails.application.config.shopsavvy_client = ShopsavvyDataApi.new(
api_key: Rails.application.credentials.shopsavvy_api_key
)
# In your models/controllers
client = Rails.application.config.shopsavvy_client
product = client.get_product_details(params[:barcode])
```
#### Error Handling
```ruby
begin
client = ShopsavvyDataApi.new(api_key: "ss_live_your_api_key_here")
product = client.get_product_details("invalid-identifier")
rescue ShopsavvyDataApi::NotFoundError => e
puts "Product not found"
rescue ShopsavvyDataApi::AuthenticationError => e
puts "Invalid API key"
rescue ShopsavvyDataApi::RateLimitError => e
puts "Rate limit exceeded"
rescue ShopsavvyDataApi::APIError => e
puts "API error: #{e.message}"
end
```
### Go SDK
Our official Go SDK provides a fast, type-safe way to interact with the ShopSavvy Data API from Go applications.
- [View on GitHub](https://github.com/shopsavvy/go-sdk)
- [View Docs on pkg.go.dev](https://pkg.go.dev/github.com/shopsavvy/go-sdk)
#### Installation
```bash
go get github.com/shopsavvy/go-sdk
```
#### Quick Start
```go
package main
import (
"fmt"
"log"
"github.com/shopsavvy/go-sdk"
)
func main() {
// Create a new client
client, err := shopsavvy.NewClient("ss_live_your_api_key_here")
if err != nil {
log.Fatal(err)
}
defer client.Close()
// Look up a product by barcode
product, err := client.GetProductDetails("012345678901")
if err != nil {
log.Fatal(err)
}
fmt.Printf("Product: %s\n", product.Data.Name)
// Get current offers
offers, err := client.GetCurrentOffers("012345678901", "")
if err != nil {
log.Fatal(err)
}
for _, offer := range offers.Data {
fmt.Printf("%s: $%.2f\n", offer.Retailer, offer.Price)
}
}
```
#### Features
- Full type safety with Go generics
- Comprehensive error handling with custom error types
- Context support for request cancellation
- Built-in rate limiting and retry logic
- Support for both JSON and CSV response formats
- Batch operations for multiple products
### Java SDK
Our official Java SDK provides enterprise-grade reliability and performance for Java applications.
- [View on GitHub](https://github.com/shopsavvy/java-sdk)
- [Maven Central](https://search.maven.org/artifact/com.shopsavvy/shopsavvy-sdk-java)
#### Installation
**Maven:**
```xml
com.shopsavvy
shopsavvy-sdk
1.0.0
```
**Gradle:**
```groovy
implementation 'com.shopsavvy:shopsavvy-sdk:1.0.0'
```
#### Quick Start
```java
import com.shopsavvy.ShopSavvyClient;
import com.shopsavvy.model.Product;
import com.shopsavvy.model.ApiResponse;
public class Example {
public static void main(String[] args) {
// Create a new client
ShopSavvyClient client = new ShopSavvyClient("ss_live_your_api_key_here");
try {
// Get product details
ApiResponse response = client.getProductDetails("012345678901");
Product product = response.getData();
System.out.println("Product: " + product.getName());
System.out.println("Brand: " + product.getBrand());
// Get current offers
var offers = client.getCurrentOffers("012345678901");
offers.getData().forEach(offer -> {
System.out.printf("%s: $%.2f%n",
offer.getRetailer(), offer.getPrice());
});
} catch (Exception e) {
System.err.println("Error: " + e.getMessage());
}
}
}
```
#### Features
- Full Java type safety with generics
- Builder pattern for configuration
- Async support with CompletableFuture
- Spring Boot auto-configuration
- Jackson JSON serialization
- Comprehensive error handling
### PHP SDK
Our official PHP SDK provides easy integration for PHP applications and frameworks like Laravel, Symfony, and CodeIgniter.
- [View on GitHub](https://github.com/shopsavvy/php-sdk)
- [Packagist](https://packagist.org/packages/shopsavvy/sdk)
#### Installation
```bash
composer require shopsavvy/shopsavvy-sdk-php
```
#### Quick Start
```php
getProductDetails('012345678901');
echo "Product: " . $product['data']['name'] . "\n";
// Get current offers
$offers = $client->getCurrentOffers('012345678901');
foreach ($offers['data'] as $offer) {
echo $offer['retailer'] . ": $" . $offer['price'] . "\n";
}
// Get price history
$history = $client->getPriceHistory(
'012345678901',
'2024-01-01',
'2024-01-31'
);
```
#### Laravel Integration
```php
// config/services.php
'shopsavvy' => [
'api_key' => env('SHOPSAVVY_API_KEY'),
],
// In your controller
use ShopSavvy\Client;
class ProductController extends Controller
{
public function show($barcode)
{
$client = new Client(config('services.shopsavvy.api_key'));
$product = $client->getProductDetails($barcode);
return view('product.show', compact('product'));
}
}
```
#### Features
- PSR-4 autoloading
- Laravel service provider
- Guzzle HTTP client
- Comprehensive error handling
- Support for PHP 8.0+
- Full PHPDoc documentation
### C# SDK
Our official C# SDK provides seamless integration for .NET applications, with full async/await support and strong typing.
- [View on GitHub](https://github.com/shopsavvy/csharp-sdk)
- [NuGet](https://www.nuget.org/packages/ShopSavvy.SDK/)
#### Installation
```bash
dotnet add package ShopSavvy.SDK
```
#### Quick Start
```csharp
using ShopSavvy;
// Create a new client
var client = new ShopSavvyClient("ss_live_your_api_key_here");
// Get product details
var product = await client.GetProductDetailsAsync("012345678901");
Console.WriteLine($"Product: {product.Data.Name}");
// Get current offers
var offers = await client.GetCurrentOffersAsync("012345678901");
foreach (var offer in offers.Data)
{
Console.WriteLine($"{offer.Retailer}: ${offer.Price:F2}");
}
// Get price history
var history = await client.GetPriceHistoryAsync(
"012345678901",
new DateTime(2024, 1, 1),
new DateTime(2024, 1, 31)
);
```
#### Dependency Injection
```csharp
// Program.cs or Startup.cs
services.AddShopSavvy(options =>
{
options.ApiKey = Configuration["ShopSavvy:ApiKey"];
options.BaseUrl = "https://api.shopsavvy.com/v1";
});
// In your controller
[ApiController]
public class ProductsController : ControllerBase
{
private readonly IShopSavvyClient _client;
public ProductsController(IShopSavvyClient client)
{
_client = client;
}
[HttpGet("{barcode}")]
public async Task GetProduct(string barcode)
{
var product = await _client.GetProductDetailsAsync(barcode);
return Ok(product);
}
}
```
#### Features
- Full async/await support
- Strong typing with C# models
- Dependency injection support
- ConfigureAwait(false) for library code
- Custom exception types
- Support for .NET 6+
### Rust SDK
Our official Rust SDK provides memory-safe, high-performance access to the ShopSavvy Data API with full type safety.
- [View on GitHub](https://github.com/shopsavvy/rust-sdk)
- [Crates.io](https://crates.io/crates/shopsavvy)
#### Installation
```toml
[dependencies]
shopsavvy = "1.0.0"
tokio = { version = "1.0", features = ["full"] }
```
#### Quick Start
```rust
use shopsavvy::{Client, Result};
#[tokio::main]
async fn main() -> Result<()> {
// Create a new client
let client = Client::new("ss_live_your_api_key_here")?;
// Get product details
let product = client.get_product_details("012345678901").await?;
println!("Product: {}", product.data.name);
// Get current offers
let offers = client.get_current_offers("012345678901", None).await?;
for offer in offers.data {
println!("{}: ${:.2}", offer.retailer, offer.price);
}
// Get price history
let history = client.get_price_history(
"012345678901",
"2024-01-01",
"2024-01-31",
None
).await?;
Ok(())
}
```
#### Error Handling
```rust
use shopsavvy::{Client, Error};
match client.get_product_details("invalid-id").await {
Ok(product) => println!("Found: {}", product.data.name),
Err(Error::NotFound) => println!("Product not found"),
Err(Error::RateLimit) => println!("Rate limit exceeded"),
Err(Error::Authentication) => println!("Invalid API key"),
Err(e) => println!("Other error: {}", e),
}
```
#### Features
- Memory safe with zero-cost abstractions
- Full async/await support with tokio
- Strongly typed with serde serialization
- Comprehensive error handling
- Built-in rate limiting
- Support for Rust 1.70+
### Swift SDK
Our official Swift SDK provides native iOS and macOS integration with modern Swift concurrency and SwiftUI support.
- [View on GitHub](https://github.com/shopsavvy/swift-sdk)
#### Installation
Swift Package Manager:
```swift
.package(url: "https://github.com/shopsavvy/swift-sdk.git", from: "1.0.0")
```
#### Quick Start
```swift
import ShopSavvy
// Create a new client
let client = ShopSavvyClient(apiKey: "ss_live_your_api_key_here")
// Get product details
do {
let product = try await client.getProductDetails("012345678901")
print("Product: \(product.data.name)")
// Get current offers
let offers = try await client.getCurrentOffers("012345678901")
for offer in offers.data {
print("\(offer.retailer): $\(offer.price, specifier: "%.2f")")
}
// Get price history
let history = try await client.getPriceHistory(
"012345678901",
startDate: "2024-01-01",
endDate: "2024-01-31"
)
} catch {
print("Error: \(error)")
}
```
#### SwiftUI Integration
```swift
struct ProductView: View {
@State private var product: Product?
@State private var offers: [Offer] = []
let barcode: String
let client = ShopSavvyClient(apiKey: "your_api_key")
var body: some View {
VStack {
if let product = product {
Text(product.name)
.font(.title)
LazyVStack {
ForEach(offers, id: \.id) { offer in
HStack {
Text(offer.retailer)
Spacer()
Text("$\(offer.price, specifier: "%.2f")")
}
}
}
}
}
.task {
await loadProduct()
}
}
private func loadProduct() async {
do {
let productResponse = try await client.getProductDetails(barcode)
let offersResponse = try await client.getCurrentOffers(barcode)
await MainActor.run {
self.product = productResponse.data
self.offers = offersResponse.data
}
} catch {
print("Error loading product: \(error)")
}
}
}
```
#### Features
- Modern Swift concurrency (async/await)
- SwiftUI and UIKit support
- Codable models for type safety
- iOS 15+ and macOS 12+ support
- Built-in error handling
- Network layer with URLSession
### Kotlin SDK
Our official Kotlin SDK provides native Android integration with coroutines support and modern Kotlin idioms.
- [View on GitHub](https://github.com/shopsavvy/kotlin-sdk)
- [Maven Central](https://search.maven.org/artifact/com.shopsavvy/shopsavvy-sdk-kotlin)
#### Installation
```kotlin
// build.gradle.kts
dependencies {
implementation("com.shopsavvy:shopsavvy-sdk-kotlin:1.0.0")
}
```
#### Quick Start
```kotlin
import com.shopsavvy.sdk.*
import kotlinx.coroutines.runBlocking
fun main() = runBlocking {
// Create a new client
val client = ShopSavvyClient("ss_live_your_api_key_here")
try {
// Get product details
val product = client.getProductDetails("012345678901")
println("Product: ${product.data.name}")
// Get current offers
val offers = client.getCurrentOffers("012345678901")
offers.data.forEach { offer ->
println("${offer.retailer}: $${offer.price}")
}
// Get price history
val history = client.getPriceHistory(
"012345678901",
"2024-01-01",
"2024-01-31"
)
} catch (e: Exception) {
println("Error: ${e.message}")
}
}
```
#### Android Integration
```kotlin
class ProductRepository(private val client: ShopSavvyClient) {
suspend fun getProduct(barcode: String): Result =
try {
val response = client.getProductDetails(barcode)
Result.success(response.data)
} catch (e: Exception) {
Result.failure(e)
}
}
// In your ViewModel
class ProductViewModel(
private val repository: ProductRepository
) : ViewModel() {
private val _product = MutableLiveData()
val product: LiveData = _product
fun loadProduct(barcode: String) {
viewModelScope.launch {
repository.getProduct(barcode)
.onSuccess { _product.value = it }
.onFailure { /* handle error */ }
}
}
}
```
#### Features
- Full coroutines support
- Null safety with Kotlin types
- Android lifecycle awareness
- OkHttp-based HTTP client
- Serialization with kotlinx.serialization
- Support for Android API 21+
### SDK Comparison
Choose the right SDK for your technology stack. All SDKs provide the same comprehensive API coverage with language-specific optimizations.
| Feature | TypeScript/JavaScript | Python | Ruby |
|---------|----------------------|--------|------|
| Package Manager | npm, yarn, bun | pip | gem, bundler |
| Type Safety | Full TypeScript | Pydantic models | Runtime validation |
| Async Support | Native async/await | Sync + async variants | Sync only |
| Environment | Node.js, Browser | Python 3.8+ | Ruby 2.7+ |
| Error Handling | Comprehensive | Exception hierarchy | Custom error classes |
| Framework Integration | React, Next.js, Express | Django, FastAPI, Flask | Rails, Sinatra |
| Documentation | TSDoc + examples | Google-style + Sphinx | YARD + examples |
#### Quick Installation Comparison
| SDK | Install | Best For |
|-----|---------|----------|
| TypeScript/JavaScript | `npm install @shopsavvy/sdk` | Frontend apps, Node.js services, full-stack applications |
| Python | `pip install shopsavvy-data-api` | Data science, ML pipelines, Django/FastAPI apps |
| Ruby | `gem install shopsavvy_data_api` | Rails applications, Ruby scripts, background jobs |
| Go | `go get github.com/shopsavvy/go-sdk` | High-performance services, microservices |
| Java | `com.shopsavvy:shopsavvy-sdk:1.0.0` (Maven/Gradle) | Enterprise Java apps, Spring Boot |
| PHP | `composer require shopsavvy/shopsavvy-sdk-php` | Laravel, Symfony, PHP web apps |
| C# | `dotnet add package ShopSavvy.SDK` | .NET applications, ASP.NET |
| Rust | `shopsavvy = "1.0.0"` (Cargo) | Systems programming, high-performance |
| Swift | SPM: `https://github.com/shopsavvy/swift-sdk.git` | iOS, macOS native apps |
| Kotlin | `com.shopsavvy:shopsavvy-sdk-kotlin:1.0.0` (Gradle) | Android apps, Kotlin services |
#### When to Use Each SDK
**Choose TypeScript/JavaScript if:**
- Building web applications or Node.js services
- Need browser compatibility
- Want the best type safety and IDE support
- Using modern JavaScript frameworks
**Choose Python if:**
- Building data analysis or ML applications
- Need both sync and async support
- Want comprehensive type validation
- Using Django, FastAPI, or Flask
**Choose Ruby if:**
- Building Rails applications
- Want idiomatic Ruby patterns
- Need excellent Rails integration
- Prefer Ruby's expressive syntax
---
## AI Integration
### Model Context Protocol Server
Connect AI assistants directly to ShopSavvy's product database. The open-source MCP server enables Claude Desktop, Cursor, and other AI assistants to access product lookups, pricing data, and price history through natural conversation.
- [View on GitHub](https://github.com/shopsavvy/shopsavvy-mcp-server)
- [Learn about MCP](https://modelcontextprotocol.io)
### Claude Desktop Setup
#### 1. Install the MCP Server
```bash
npm install -g shopsavvy-data-api-mcp
```
#### 2. Configure Claude Desktop
Add to your Claude Desktop config file:
```json
{
"mcpServers": {
"shopsavvy-data-api": {
"command": "npx",
"args": ["shopsavvy-data-api-mcp"],
"env": {
"SHOPSAVVY_API_KEY": "ss_live_your_key_here"
}
}
}
}
```
#### 3. Get Your API Key
- [Subscribe to a Plan](https://shopsavvy.com/data#pricing)
- [Create API Key](https://shopsavvy.com/data/dashboard)
### Available AI Tools
| Tool | Description |
|------|-------------|
| Product Lookup | Find products by barcode, ASIN, URL, or model number |
| Current Pricing | Get offers from all retailers or specific stores |
| Price History | Historical pricing data with custom date ranges |
| Price Monitoring | Schedule automatic price tracking |
| Usage Analytics | Track API usage and credit consumption |
### Usage Examples
**Product Research:**
- "Look up the product with barcode 012345678901"
- "Find product information for ASIN B08N5WRWNW"
- "Get details for this Amazon URL: https://amazon.com/dp/B08N5WRWNW"
**Price Comparison:**
- "Show me current prices for ASIN B08N5WRWNW from all retailers"
- "Get Amazon prices for product 012345678901"
- "Compare Best Buy and Target prices for this product"
**Price History:**
- "Get price history for B08N5WRWNW from January 1-31, 2024"
- "Show me price trends for the last 3 months"
- "What were Amazon's prices for this product in December?"
**Price Monitoring:**
- "Schedule daily price monitoring for these products"
- "Set up hourly monitoring for ASIN B08N5WRWNW"
- "Show me all my scheduled products"
### Advanced Features
- **Open Source** - MIT licensed and available on GitHub for customization and contributions.
- **Easy Integration** - Works with Claude Desktop, Cursor, and any MCP-compatible AI assistant.
- **Batch Operations** - Look up multiple products, compare prices across retailers, and manage large product catalogs efficiently.
- **Usage Tracking** - Built-in usage analytics help you monitor API consumption and optimize your credit usage.
**Credit Usage:** The MCP server uses the same credit system as the REST API. Each AI tool interaction consumes credits based on the data requested.
---
## Products API
### Retrieving Product Details
**Cost:** 1 credit per product requested.
You can retrieve product details by using the `GET /products?ids={identifiers}` endpoint.
The `identifiers` parameter can be a comma-separated list of **one** or **more** identifiers. You can mix and match any combination of different identifiers, like `GET /products?ids=B07G14HTBZ,611247369449,3ONn300xybP3y66ibqc1`.
An identifier can be any of the following:
- UPC
- EAN
- ISBN
- GTIN
- Amazon ASIN
- Model Number
- Product Name
- URL at any Retailer
- ShopSavvy Product ID
#### Examples
**Example with barcodes:**
```bash
curl -X GET "https://api.shopsavvy.com/v1/products?ids=611247373064,611247369449" \
-H "Authorization: Bearer ss_live_your_api_key_here"
```
**Example with product name:**
```bash
curl -X GET "https://api.shopsavvy.com/v1/products?ids=iPhone%2015%20Pro" \
-H "Authorization: Bearer ss_live_your_api_key_here"
```
**Note:** When using a product name, the API uses full-text search to find the best matching product based on relevance and offer availability.
#### Response Format
The response will be a JSON object with success status, data array, and metadata including credits used.
Products will each have the following fields. (Note: not all fields are available on all products).
| Field | Description |
|-------|-------------|
| `title` | The name of the product. |
| `title_short` | A shorter, human-friendly version of the title (when available). |
| `slug` | URL-friendly slug for the product. |
| `category` | A comma separated list of categories for the product. |
| `brand` | The brand of the product. |
| `color` | The color of the product. |
| `model` | The model of the product. |
| `shopsavvy` | The ShopSavvy Product ID of the product. This can optionally be used alongside any other identifier when retrieving products, offers, etc. |
| `barcode` | The barcode of the product. Will always be a number. |
| `amazon` | The Amazon ASIN of the product. |
| `mpn` | The manufacturer's part number of the product. |
| `images` | An array of image URLs pointing to images of the product. |
| `identifiers` | All known identifiers for the product (barcode, amazon, walmart, bestbuy, newegg, etc.). |
| `description` | Product description text (single best available description). |
| `categories` | Array of category path strings. |
| `attributes` | Product specifications as a flat object (e.g., `{"Color": "Black", "Weight": "250g"}`). |
| `rating` | Aggregated customer rating with `value` (out of 5) and `count` (total reviews). |
| `score` | Expert quality scores: `overall`, `customer`, `professional`, `value`, `features`, `reliability` (all on a 0-100 scale, only populated fields included). |
| `keywords` | Array of relevant search keywords for the product. |
All response `meta` objects now include a `request_id` field — a unique identifier for every API request. Include this in any support inquiries.
**Error Responses** include both a human-readable `error` string and a structured `error_detail` object with `code`, `message`, `action` (what to do), and `docs_url` (link to relevant documentation).
#### Example Response
```json
{
"success": true,
"data": [
{
"title": "Keurig K-Mini Single Serve Coffee Maker, Black",
"category": "Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",
"brand": "Keurig",
"color": "Black",
"model": "K-MINI",
"shopsavvy": "products/3ONn300xybP3y66ibqc1",
"barcode": 611247373064,
"amazon": "B07G14HTBZ",
"mpn": "5000200237",
"images": [
"https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg",
"https://images-na.ssl-images-amazon.com/images/I/411uxu%2Bg17L.jpg",
"https://images-na.ssl-images-amazon.com/images/I/41jEx1YoTQL.jpg",
"https://images-na.ssl-images-amazon.com/images/I/41CanelWIlL.jpg"
]
},
{
"title": "Keurig K-Elite Single Serve K-Cup Pod Maker with Strength and Temperature Control, Iced Coffee Capability, 12oz Brew Size, Brushed Silver",
"category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Makers > Single-Serve Brewers",
"brand": "Keurig",
"color": "Silver",
"model": "K-Elite",
"shopsavvy": "products/DrKWneG0MpFlZpwZXNYa",
"barcode": 611247369449,
"amazon": "B0788F3R8X",
"mpn": "5000197492",
"images": [
"https://images-na.ssl-images-amazon.com/images/I/411fEW99TlL.jpg",
"https://images-na.ssl-images-amazon.com/images/I/51bdqFw6lNL.jpg",
"https://images-na.ssl-images-amazon.com/images/I/51-NbDX9S7L.jpg",
"https://images-na.ssl-images-amazon.com/images/I/412o2pQ-swL.jpg"
]
}
],
"meta": {
"credits_used": 2,
"credits_remaining": 998,
"rate_limit_remaining": 58
}
}
```
### Retrieving Product Details in CSV Format
**Cost:** 1 credit per product requested.
By default all responses are in JSON format, but you can also retrieve products in CSV format by adding `?format=csv` to the request:
```
GET /products?ids=611247373064,611247369449&format=csv
```
When you do this, the response will be formatted as a CSV file, with columns for each of the different fields, and each product on its own row:
```csv
shopsavvy,barcode,amazon,title,category,brand,color,mpn,model,image
3ONn300xybP3y66ibqc1,611247373064,B07G14HTBZ,"Keurig K-Mini Single Serve Coffee Maker, Black","Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",Keurig,Black,5000200237,K-MINI,https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg
DrKWneG0MpFlZpwZXNYa,611247369449,B0788F3R8X,"Keurig K-Elite Single Serve K-Cup Pod Maker with with Strength and Temperature Control, Iced Coffee Capability, 12oz Brew Size, Brushed Silver","Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Makers > Single-Serve Brewers",Keurig,Silver,5000197492,K-Elite,https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/411fEW99TlL.jpg
```
### Searching Products by Keyword
**Cost:** 1 credit per product returned.
You can search for products by keyword using the `GET /products/search?q={query}` endpoint.
This endpoint uses PostgreSQL full-text search to find products matching your search query. Results are ranked by a composite score that combines:
- **Text Relevance (70%)**: How well the product title, brand, and model match your search query
- **Offer Count (25%)**: Products with more current offers are ranked higher (indicates active products)
- **Recency (5%)**: Recently updated products are slightly preferred
#### Query Parameters
| Parameter | Required | Description |
|-----------|----------|-------------|
| `q` | Yes | Search query or keyword (e.g., "iphone 15 pro", "samsung tv", "nike shoes") |
| `limit` | No | Maximum number of results to return (default: 20, max: 100) |
| `offset` | No | Offset for pagination (default: 0) |
#### Example Request
```bash
curl -X GET "https://api.shopsavvy.com/v1/products/search?q=iphone%2015%20pro&limit=10" \
-H "Authorization: Bearer ss_live_your_api_key_here"
```
#### Example Response
```json
{
"success": true,
"data": [
{
"title": "Apple iPhone 15 Pro Max 256GB - Natural Titanium",
"category": "Cell Phones & Accessories > Cell Phones > Smartphones",
"brand": "Apple",
"color": "Natural Titanium",
"model": "iPhone 15 Pro Max",
"shopsavvy": "products/abc123xyz",
"barcode": 195949038674,
"amazon": "B0CHX3TZ7R",
"mpn": "MU773LL/A",
"images": [
"https://images-na.ssl-images-amazon.com/images/I/41BvSLn90ML.jpg",
"https://images-na.ssl-images-amazon.com/images/I/51ckLKbsOsL.jpg"
]
},
{
"title": "Apple iPhone 15 Pro 128GB - Blue Titanium",
"category": "Cell Phones & Accessories > Cell Phones > Smartphones",
"brand": "Apple",
"color": "Blue Titanium",
"model": "iPhone 15 Pro",
"shopsavvy": "products/def456uvw",
"barcode": 195949037894,
"amazon": "B0CHX1W1XY",
"mpn": "MTUX3LL/A",
"images": [
"https://images-na.ssl-images-amazon.com/images/I/41m9Pq3ScgL.jpg"
]
}
],
"pagination": {
"total": 47,
"limit": 10,
"offset": 0,
"returned": 2
},
"meta": {
"credits_used": 2,
"credits_remaining": 998,
"rate_limit_remaining": 58
}
}
```
#### Use Cases
- **Autocomplete / Search Suggestions**: Use with a low limit (e.g., 5-10) to show real-time search results as users type
- **Category Browsing**: Search for broad categories like "gaming laptops" or "bluetooth speakers"
- **Product Discovery**: Find products when you don't have a specific identifier like a barcode or ASIN
- **Fuzzy Matching**: The full-text search handles typos and variations in product names
**Note:** Once you have a product from search results, you can use its `shopsavvy` ID, `barcode`, or `amazon` ASIN with the other endpoints like `GET /products/offers` to retrieve pricing data.
---
## Batch API
### Batch Product Lookup
Look up multiple products at once. For small batches (up to 20 identifiers), results are returned immediately. For larger batches (21-100), processing happens asynchronously — you receive a batch ID and poll for results.
**Endpoint:** `POST /v1/products/batch`
**Credit Cost:** Same as individual lookups (1 credit per product found, + 3 per product if including offers, + 1 per product if including reviews)
**Request Body:**
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `identifiers` | string[] | Yes | Array of product identifiers (1-100). Supports barcodes, ASINs, URLs, model numbers. |
| `include` | string[] | No | Additional data to fetch: `"offers"` and/or `"reviews"` |
**Example Request (Synchronous, <=20 identifiers):**
```bash
curl -X POST 'https://api.shopsavvy.com/v1/products/batch' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"identifiers": ["B09XS7JWHH", "B0CHX3TW6K", "027242923782"],
"include": ["offers"]
}'
```
**Synchronous Response (<=20 identifiers):**
```json
{
"success": true,
"results": [
{ "identifier": "B09XS7JWHH", "status": "found", "product": { "title": "Sony WH-1000XM5", ... }, "offers": [...] },
{ "identifier": "B0CHX3TW6K", "status": "found", "product": { "title": "iPhone 15 Pro", ... }, "offers": [...] },
{ "identifier": "INVALID123", "status": "not_found", "product": null }
],
"summary": { "total": 3, "found": 2, "not_found": 1 },
"meta": { "request_id": "abc-123", "credits_used": 8, "credits_remaining": 992 }
}
```
**Async Response (>20 identifiers):**
When submitting more than 20 identifiers, you receive a batch ID immediately:
```json
{
"success": true,
"batch": {
"id": "batch_abc123def456",
"status": "processing",
"total": 50,
"processed": 0,
"poll_url": "/v1/batch/batch_abc123def456",
"estimated_seconds": 75
}
}
```
Poll `GET /v1/batch/{batch_id}` until `status` is `"completed"`, then the response includes the full `results` array.
---
## Pricing API
### Retrieving Offers for Products at All Retailers
**Cost:** 3 credits per product requested.
An **offer** represents a **product** being sold by a specific **retailer** or **seller** for a specific price, condition, etc.
You can retrieve offers for products by using the `GET /products/offers` endpoint. The `ids` parameter supports all identifier types including barcodes, ASINs, model numbers, URLs, and **product names**.
**Example with barcodes:**
```
GET /products/offers?ids=611247373064,611247369449
```
**Example with product name:**
```
GET /products/offers?ids=iPhone%2015%20Pro
```
**Note:** When using a product name, the API uses full-text search to find the best matching product based on relevance and offer availability, then returns offers for that product.
#### Offer Fields
This will return an array of products, each containing a new `offers` property, which will be an array of offer objects, each containing the following properties:
| Field | Description |
|-------|-------------|
| `id` | A unique identifier for this offer. |
| `availability` | The availability of the product in the offer. This will only be present if the value is confirmed and known. It will be missing if availability is unknown. Will be either `"in"` or `"out"`. |
| `condition` | The condition of the product in the offer. Will be `"new"`, `"used"`, or `"refurbished"`. |
| `retailer` | The name of the retailer or marketplace the offer is for. |
| `price` | The price of the product in the offer. Will always be a number. |
| `seller` | The name of the marketplace seller selling this product. If missing, then the offer is from a first-party retailer and there is no marketplace seller. |
| `URL` | The URL for the offer. |
| `timestamp` | An [ISO 8601](https://www.w3.org/TR/NOTE-datetime) formatted date and time representing when the offer was last seen by ShopSavvy. |
#### Example Response
```json
[
{
"title": "Keurig K-Mini Single Serve Coffee Maker, Black",
"category": "Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",
"brand": "Keurig",
"color": "Black",
"model": "K-MINI",
"shopsavvy": "3ONn300xybP3y66ibqc1",
"barcode": 611247373064,
"amazon": "B07G14HTBZ",
"mpn": "5000200237",
"images": [
"https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg",
"https://images-na.ssl-images-amazon.com/images/I/411uxu%2Bg17L.jpg",
"https://images-na.ssl-images-amazon.com/images/I/41jEx1YoTQL.jpg",
"https://images-na.ssl-images-amazon.com/images/I/41CanelWIlL.jpg"
],
"offers": [
{
"id": "0IUouCFtZEhxeOablTPl",
"availability": "in",
"condition": "new",
"retailer": "Amazon",
"price": 74.96,
"seller": "Palm Tree Deals",
"URL": "https://www.amazon.com/dp/B07GV2S1GS?m=A1GKQADQC2VI6E",
"timestamp": "2022-05-01T22:36:33.236Z"
},
{
"id": "0RmL0ZMUesP2PmSlP97G",
"availability": "in",
"condition": "new",
"retailer": "Amazon",
"price": 58.86,
"URL": "https://www.amazon.com/dp/B07GV2S1GS",
"timestamp": "2022-05-03T22:52:06.802Z"
},
{
"id": "0qp0KKdFnwIi3c09kGyT",
"availability": "in",
"condition": "new",
"retailer": "Walmart",
"price": 60.34,
"URL": "https://www.walmart.com/ip/Keurig-K-Mini-Single-Serve-Coffee-Maker-Black/389238886?selectedSellerId=FBB34940E137490C8ABD825B48534874",
"timestamp": "2022-05-01T20:38:25.218Z"
},
{
"id": "2EHAxfhrvF6hEFs8IarY",
"availability": "in",
"condition": "new",
"retailer": "Walmart",
"price": 81.5,
"seller": "Focus Camera",
"URL": "https://www.walmart.com/ip/Keurig-K-Mini-Single-Serve-K-Cup-Pod-Coffee-Maker-6-to-12-oz-Brew-Sizes-Black/389238886?selectedSellerId=888853D0A1394FA4BB92C88C4FD20210",
"timestamp": "2022-05-02T20:26:42.657Z"
},
{
"id": "1upFPYp9qj74v8S0E7qp",
"availability": "in",
"condition": "refurbished",
"retailer": "shopcheap.club",
"price": 59.99,
"seller": null,
"URL": "https://shopcheap.club/kitchen-tabletop/keurig-k-mini-coffee-maker-single-serve-k-cup-pod-coffee-brewer-6-to-12-oz-brew-sizes-black/",
"timestamp": "2022-05-03T13:49:10.053Z"
}
]
}
]
```
### Retrieving Offers for a Single Retailer
**Cost:** 2 credits per product requested.
You can retrieve offers for products at a single retailer by specifying a value for the `retailer` parameter. The value should be the domain of the retailer you want to retrieve offers for, like `amazon.com` or `bestbuy.com`.
```
GET /products/offers?ids=611247373064,611247369449&retailer=amazon.com
```
The response will be in the same format and schema, but it will only contain offers from your specified retailer.
#### Example Response
```json
[
{
"title": "Keurig K-Mini Single Serve Coffee Maker, Black",
"category": "Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",
"brand": "Keurig",
"color": "Black",
"model": "K-MINI",
"shopsavvy": "3ONn300xybP3y66ibqc1",
"barcode": 611247373064,
"amazon": "B07G14HTBZ",
"mpn": "5000200237",
"images": [
"https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg"
],
"offers": [
{
"id": "0IUouCFtZEhxeOablTPl",
"availability": "in",
"condition": "new",
"retailer": "Amazon",
"price": 74.96,
"seller": "ACME Deals",
"URL": "https://www.amazon.com/dp/B07G14HTBZ?m=A1GKQADQC2VI6E",
"timestamp": "2022-05-01T22:36:33.236Z"
},
{
"id": "0RmL0ZMUesP2PmSlP97G",
"availability": "in",
"condition": "new",
"retailer": "Amazon",
"price": 58.86,
"URL": "https://www.amazon.com/dp/B07G14HTBZ",
"timestamp": "2022-05-03T22:52:06.802Z"
}
]
}
]
```
### Retrieving Offers in CSV Format
**Cost:** 3 credits per product requested when requesting all retailers, 2 credits per product when requesting a single retailer.
By default all responses are in JSON format, but you can also retrieve data in CSV format by adding `?format=csv` to the request:
```
GET /products/offers?ids=611247373064,611247369449&retailer=bestbuy.com&format=csv
```
When you do this, the response will be formatted as a CSV file, with columns for each of the different fields, and each product on its own row. Each offer field will be a separate column, allowing for easy integration into spreadsheets and other tools or workflows.
#### Example Response
```csv
shopsavvy,barcode,amazon,title,category,brand,color,mpn,model,image,currency-Best Buy,price-Best Buy,availability-Best Buy,condition-Best Buy,URL-Best Buy,timestamp-Best Buy
3ONn300xybP3y66ibqc1,611247373064,B07G14HTBZ,"Keurig K-Mini Single Serve Coffee Maker, Black","Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",Keurig,Matte Black,5000200237,K-MINI,https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg,USD,59.99,in,new,https://www.bestbuy.com/site/keurig-k-mini-single-serve-k-cup-pod-coffee-maker-matte-black/6358476.p?skuId=6358476&ref=NS&loc=101,2022-11-05T11:47:00.226Z
DrKWneG0MpFlZpwZXNYa,611247369449,B0788F3R8X,"Keurig K-Elite Single Serve K-Cup Pod Maker with with Strength and Temperature Control, Iced Coffee Capability, 12oz Brew Size, Brushed Silver","Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Makers > Single-Serve Brewers",Keurig,Brushed Silver,5000197492,K-Elite,https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/411fEW99TlL.jpg,USD,129.99,,new,https://www.bestbuy.com/site/keurig-k-elite-single-serve-k-cup-pod-coffee-maker-brushed-silver/6203569.p?skuId=6203569,2022-11-05T11:33:16.004Z
```
### Retrieving Offers With Historical Offer Data
**Cost:** 3 credits per product requested when requesting all retailers, 2 credits per product when requesting a single retailer. Additionally, there is a cost of 1 credit per day of historical data requested.
Historical data can be requested by adding `start` and `end` parameters to the request. These should be formatted as `YYYY-MM-DD`.
```
GET /products/offers/history?ids=611247373064&start=2022-11-20&end=2022-11-27
```
Please note you'll be charged **1 credit** for each day of historical data you request.
The response will be in the same format and schema as requests for offers, but each offer will include a `history` field, which will contain an array of historical changes for that specific offer. Each change will include these fields:
| Field | Description |
|-------|-------------|
| `timestamp` | An [ISO 8601](https://www.w3.org/TR/NOTE-datetime) formatted date and time representing when the change was seen by ShopSavvy. |
| `price` | The price of the offer at the time of the change. This will always be a number. |
| `availability` | The availability of the offer at the time of the change. This will only be present if the value is confirmed and known. It will be missing if availability is unknown. Will be either `"in"` or `"out"`. |
#### Example Response
```json
[
{
"title": "Keurig K-Mini Single Serve Coffee Maker, Black",
"category": "Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",
"brand": "Keurig",
"color": "Black",
"model": "K-MINI",
"shopsavvy": "3ONn300xybP3y66ibqc1",
"barcode": 611247373064,
"amazon": "B07G14HTBZ",
"mpn": "5000200237",
"images": [
"https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg"
],
"offers": [
{
"id": "0IUouCFtZEhxeOablTPl",
"availability": "in",
"condition": "new",
"retailer": "Amazon",
"price": 74.96,
"seller": "ACME Deals",
"URL": "https://www.amazon.com/dp/B07G14HTBZ?m=A1GKQADQC2VI6E",
"timestamp": "2022-05-01T22:36:33.236Z",
"history": [
{
"timestamp": "2022-05-01T22:36:33.236Z",
"price": 74.96,
"availability": "in"
},
{
"timestamp": "2022-05-02T22:36:33.236Z",
"price": 70.99,
"availability": "in"
},
{
"timestamp": "2022-05-01T22:36:33.236Z",
"price": 70.99,
"availability": "out"
}
]
}
]
}
]
```
---
## Scheduling API
### Enabling Scheduled Refreshes for Products
**Cost:** 1 credit per product scheduled + 3 credits every time each scheduled product is refreshed.
Enabling scheduled refreshes for products will cause ShopSavvy to refresh the pricing and availability data for the specified products on an interval you specify.
You can schedule one or more products using the same `ids` parameter as the `GET /products` and `GET /products/offers` endpoints.
Use the `schedule` parameter to specify how frequently you like the product(s) refreshed. This can be a string with a value of `"hourly"`, `"daily"`, or `"weekly"`.
```
PUT /products/scheduled?ids=611247373064,611247369449&schedule=daily
```
This will begin refreshing the pricing and availability for the product(s), and return products that were just scheduled. Note: You will need to call the `GET /products/offers` endpoint whenever you want to retrieve the latest data.
### Changing Refresh Schedule for Products
**Cost:** 1 credit per product scheduled + 3 credits every time each scheduled product is refreshed.
You can change how frequently previously scheduled product(s) are refreshed by calling the same endpoint but with a `POST`. Everything else works the same as enabling scheduled refreshes for new products.
Use the `schedule` parameter to specify how frequently you like the product(s) refreshed. This can be a string with a value of `"hourly"`, `"daily"`, or `"weekly"`.
```
POST /products/scheduled?ids=611247373064&schedule=hourly&retailer=bestbuy.com
```
This will begin refreshing the pricing and availability for the product(s), and return products that had their refresh schedule changed. Note: You will need to call the `GET /products/offers` endpoint whenever you want to retrieve the latest data.
### Disabling Scheduled Refreshes for Products
**Cost:** 0 credits per product scheduled.
Disabling scheduled refreshes for products will cause ShopSavvy to stop refreshing the pricing and availability data for the specified products.
```
DELETE /products/scheduled?ids=611247369449
```
### Retrieve Products Currently Enabled for Scheduled Refreshes
**Cost:** 0 credits.
```
GET /products/scheduled
```
This returns all the products you currently have enabled for scheduled refreshes, along with each of their configuration and refresh interval.
#### Example Response
```json
[
{
"schedule": "hourly",
"title": "Keurig K-Mini Single Serve Coffee Maker, Black",
"category": "Grocery & Gourmet Food > Beverages > Coffee, Tea & Cocoa > Coffee > Single-Serve Capsules & Pods",
"brand": "Keurig",
"color": "Black",
"model": "K-MINI",
"shopsavvy": "3ONn300xybP3y66ibqc1",
"barcode": 611247373064,
"amazon": "B07G14HTBZ",
"mpn": "5000200237",
"images": [
"https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/31jy5fSzyRL.jpg"
]
},
{
"schedule": "daily",
"retailer": "bestbuy.com",
"title": "Keurig K-Elite Single Serve K-Cup Pod Maker with Strength and Temperature Control, Iced Coffee Capability, 12oz Brew Size, Brushed Silver",
"category": "Home & Kitchen > Kitchen & Dining > Coffee, Tea & Espresso > Coffee Makers > Single-Serve Brewers",
"brand": "Keurig",
"color": "Silver",
"model": "K-Elite",
"shopsavvy": "DrKWneG0MpFlZpwZXNYa",
"barcode": 611247369449,
"amazon": "B0788F3R8X",
"mpn": "5000197492",
"images": [
"https://x.shopsavvy.com/https://images-na.ssl-images-amazon.com/images/I/411fEW99TlL.jpg"
]
}
]
```
---
## Deals API
### Browse Deals
Retrieve a feed of current shopping deals with Reddit-style sorting, filtering, and pagination. Each deal includes an expert grade (A+ through F), pricing, retailer info, community votes, and more.
**Endpoint:** `GET /v1/deals`
**Credit Cost:** 1 credit per 10 deals returned
**Parameters:**
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `sort` | string | `hot` | Sort algorithm: `hot`, `new`, `top-hour`, `top-day`, `top-week` |
| `limit` | number | 25 | Results per page (1-100) |
| `offset` | number | 0 | Pagination offset |
| `category` | string | | Filter by product category |
| `retailer` | string | | Filter by retailer domain (e.g., `amazon.com`) |
| `tag` | string | | Filter by deal tag |
| `min_price` | number | | Minimum deal price |
| `max_price` | number | | Maximum deal price |
| `grade` | string | | Minimum grade: `A`, `B`, `C`, `D` |
| `format` | string | `json` | Response format: `json` or `csv` |
**Boolean Filters** (set to `true` to filter): `is_percentage_off`, `is_dollar_off`, `is_bogo`, `is_price_drop`, `is_free_shipping`, `is_fast_shipping`, `is_limited_time`, `is_clearance`, `is_new_product`, `is_bundle`, `is_refurbished`, `is_open_box`, `requires_membership`, `has_coupon_code`, `has_mail_in_rebate`
**Example Request:**
```bash
curl -X GET 'https://api.shopsavvy.com/v1/deals?sort=hot&limit=10&grade=B' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
**Example Response:**
```json
{
"success": true,
"deals": [
{
"path": "deals/abc123",
"title": "Sony WH-1000XM5 Wireless Headphones - 25% Off",
"subtitle": "Lowest price in 3 months",
"description": "Industry-leading noise cancellation headphones at a rare discount...",
"emoji": "🎧",
"grade": { "letter": "A", "suffix": "+", "value": 0.98, "justification": "Excellent price on a top-rated product" },
"pricing": { "current": 248.00, "original": 349.99, "currency": "USD" },
"retailer": { "name": "Amazon" },
"url": "https://...",
"image": { "url": "https://..." },
"votes": { "upvotes": 142, "downvotes": 3, "score": 139 },
"comment_count": 23,
"tags": [{ "slug": "electronics", "display": "Electronics" }],
"expires_at": "2026-04-15T00:00:00Z",
"created_at": "2026-03-28T12:00:00Z"
}
],
"pagination": { "total": 487, "has_more": true, "limit": 10, "offset": 0 },
"meta": { "request_id": "abc-123", "credits_used": 1, "credits_remaining": 999 }
}
```
---
## Reviews API
### Get TLDR Review for Product
Retrieve a concise expert review summary for a product, including pros, cons, a bottom line verdict, and quantitative scores. These are curated TLDR reviews — not raw customer reviews.
**Endpoint:** `GET /v1/products/reviews`
**Credit Cost:** 1 credit per product
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Product identifier (barcode, ASIN, URL, model number) |
| `format` | string | No | Response format: `json` or `csv` |
**Example Request:**
```bash
curl -X GET 'https://api.shopsavvy.com/v1/products/reviews?id=B09XS7JWHH' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
**Example Response:**
```json
{
"success": true,
"product": { "path": "products/sony-wh1000xm5", "title": "Sony WH-1000XM5" },
"review": {
"slug": "sony-wh-1000xm5-review",
"headline": "Best-in-class noise cancellation with premium sound",
"pros": ["Industry-leading ANC", "30-hour battery life", "Comfortable all-day wear"],
"cons": ["No IP rating", "No aptX support", "Premium pricing"],
"bottom_line": "The best noise-cancelling headphones for most people.",
"scores": { "overall": 87, "customer": 85, "professional": 89, "value": 78, "features": 91, "reliability": 83 }
},
"meta": { "request_id": "abc-123", "credits_used": 1, "credits_remaining": 998 }
}
```
**Note:** Returns `"review": null` if no TLDR review exists for the product (1 credit is still charged).
---
## Webhooks
Register webhook URLs to get notified when prices drop, product availability changes, or scheduled refreshes complete.
### Create Webhook
**Endpoint:** `POST /v1/webhooks`
**Request Body:**
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | HTTPS URL to receive webhook POST requests |
| `events` | string[] | Yes | Event types: `price_drop`, `availability_change`, `schedule_completion` |
**Example:**
```bash
curl -X POST 'https://api.shopsavvy.com/v1/webhooks' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"url": "https://your-app.com/webhooks/shopsavvy", "events": ["price_drop", "availability_change"]}'
```
The response includes a `secret` field (shown once) — use it to verify webhook signatures.
### Verifying Webhook Signatures
Every webhook delivery includes an `X-ShopSavvy-Signature` header with format: `t=,v1=`.
To verify: compute `HMAC-SHA256(secret, ".")` and compare to `v1`.
### List Webhooks
`GET /v1/webhooks` — Returns all your registered webhooks with status and failure counts.
### Test Webhook
`POST /v1/webhooks/:id/test` — Sends a test event to verify your URL is reachable.
### Delete Webhook
`DELETE /v1/webhooks/:id` — Permanently removes a webhook and all its event history.
**Retry Policy:** Failed deliveries are retried with exponential backoff (1min, 5min, 30min, 2hr, 12hr). After 5 failed attempts per event, the event is marked as permanently failed. After 50 consecutive failures, the webhook is automatically disabled.
**Limits:** Maximum 5 webhooks per account. Maximum 3 event types per webhook.
---
## Analytics & Tools
### Get API Usage Statistics
**Cost:** 0 credits.
You can retrieve your current API usage statistics and limits by using the `GET /usage` endpoint.
```bash
curl -X GET "https://api.shopsavvy.com/v1/usage" \
-H "Authorization: Bearer ss_live_your_api_key_here"
```
This will return information about your current billing period usage, including credits used, remaining credits, and the percentage of your monthly limit used.
#### Example Response
```json
{
"success": true,
"data": {
"current_period": {
"start_date": "2025-01-01",
"end_date": "2025-01-31",
"credits_used": 1500,
"credits_limit": 10000,
"credits_remaining": 8500,
"requests_made": 245
},
"usage_percentage": 15
},
"meta": {
"credits_used": 0,
"credits_remaining": 8500,
"rate_limit_remaining": 50
}
}
```
#### Response Fields
| Field | Description |
|-------|-------------|
| `start_date` / `end_date` | Your current billing period dates. |
| `credits_used` | Total credits consumed this billing period. |
| `credits_limit` | Your monthly credit allowance based on your subscription plan. |
| `credits_remaining` | Credits left for the current billing period. |
| `requests_made` | Total API requests made this billing period. |
| `usage_percentage` | Percentage of your monthly limit used. |
### CSV to API Request Converter
This is an interactive tool on the documentation page that allows you to upload a CSV file, choose a column to use as product identifiers, and it will generate the HTTP path to request from the API to get product or pricing data for each of those products in a single request.
The tool supports:
- **Pasting CSV content** directly
- **Selecting an identifier column** from your CSV headers
- **Skipping the first row** (header row) toggle
- **Request type selection**: Product Details or Product Offers
- **Retailer filtering**: All Retailers or Single Retailer (with domain input, e.g., `bestbuy.com`)
- **Response format**: CSV or JSON
The generated API request path can be copied and used directly with `curl` or any HTTP client.
### Rate Limits
API requests are subject to rate limiting to ensure fair usage across all subscribers. The `meta` object in every API response includes `rate_limit_remaining` which shows how many requests you can make in the current window.
Rate limit information is included in every API response:
```json
{
"meta": {
"credits_used": 2,
"credits_remaining": 998,
"rate_limit_remaining": 58
}
}
```
---
## Quick Reference: All Endpoints
| Method | Endpoint | Description | Cost |
|--------|----------|-------------|------|
| `GET` | `/products?ids={identifiers}` | Get product details | 1 credit/product |
| `GET` | `/products?ids={identifiers}&format=csv` | Get product details in CSV | 1 credit/product |
| `GET` | `/products/search?q={query}` | Search products by keyword | 1 credit/product returned |
| `GET` | `/products/offers?ids={identifiers}` | Get offers from all retailers | 3 credits/product |
| `GET` | `/products/offers?ids={identifiers}&retailer={domain}` | Get offers from single retailer | 2 credits/product |
| `GET` | `/products/offers?ids={identifiers}&format=csv` | Get offers in CSV format | 3 or 2 credits/product |
| `GET` | `/products/offers/history?ids={identifiers}&start={date}&end={date}` | Get price history | Offer cost + 1 credit/day |
| `PUT` | `/products/scheduled?ids={identifiers}&schedule={interval}` | Enable scheduled monitoring | 1 credit + 3 credits/refresh |
| `POST` | `/products/scheduled?ids={identifiers}&schedule={interval}` | Update monitoring schedule | 1 credit + 3 credits/refresh |
| `DELETE` | `/products/scheduled?ids={identifiers}` | Disable scheduled monitoring | 0 credits |
| `GET` | `/products/scheduled` | View all scheduled products | 0 credits |
| `GET` | `/usage` | Get usage statistics | 0 credits |
**Base URL:** `https://api.shopsavvy.com/v1`
**Authentication:** `Authorization: Bearer ss_live_your_api_key_here`
**Supported Identifiers:** UPC, EAN, ISBN, GTIN, Amazon ASIN, Model Number, Product Name, URL at any retailer, ShopSavvy Product ID
**Schedule Intervals:** `"hourly"`, `"daily"`, `"weekly"`
**Response Formats:** JSON (default), CSV (add `&format=csv`)
---
# ShopSavvy Data API - Changelog
> Version history, feature updates, and breaking changes
*Source: https://shopsavvy.com/data/changelog*
---
## 2026-04-07
### Added
- **Webhook system** — Register URLs to receive notifications on price drops, availability changes, and schedule completions. Includes HMAC-SHA256 signature verification, exponential backoff retry, and auto-disable after failures.
- **OpenAPI 3.0 spec** — Full API specification available at `/v1/openapi.json` for Postman import, SDK generation, and tooling integration.
- **Credit usage alerts** — `X-Credits-Warning` response header when usage exceeds 75%. Dashboard warning banner at 75%, 90%, and 100% thresholds.
- **Persistent sidebar navigation** — All dashboard pages now have a Stripe-style sidebar with quick access to all sections and a credit usage indicator.
- **Usage charts** — Daily usage line chart and endpoint breakdown bar chart on the dashboard using Chart.js.
- **11 SDK code snippet languages** — Code examples now cover cURL, TypeScript, Python, Go, Ruby, Java, PHP, C#, Rust, Swift, and Kotlin.
- **Collapsible JSON tree viewer** — Interactive response viewer in the playground with expand/collapse, color-coded values, and Raw JSON toggle.
- **Table view for arrays** — Offers, deals, and search results can be viewed as sortable tables in the playground.
- **Response metrics** — Response time (ms) and payload size (KB) badges shown after each playground request.
### Changed
- **Expanded product fields** — Product responses now include `title_short`, `slug`, `description`, `categories`, `attributes`, `rating`, `score`, `keywords`, and `identifiers`.
- **Improved error responses** — All errors now include `error_detail` with `code`, `message`, `action`, and `docs_url`. Every response includes `request_id` in meta.
- **Retry-After header** — 429 rate limit responses now include standard `Retry-After` HTTP header.
---
## 2026-04-06
### Added
- **Deals endpoint** — `GET /v1/deals` returns a curated deals feed with expert grades (A+ through F), community votes, Reddit-style sorting (hot, new, top), filtering by category/retailer/price/grade, and CSV export.
- **TLDR Reviews endpoint** — `GET /v1/products/reviews` returns expert review summaries with pros, cons, bottom line verdict, and unified quality scores.
- **Batch product lookup** — `POST /v1/products/batch` for looking up multiple products at once. Synchronous for ≤20 identifiers, async with polling for larger batches. Optionally includes offers and/or reviews.
- **CSV format support** — `?format=csv` now works on all endpoints including search and price history.
- **Standardized error codes** — 13 error codes (ERR_AUTH_MISSING through ERR_INTERNAL) with actionable messages and documentation links.
---
## 2026-03-15
### Added
- **Product Search endpoint** — `GET /v1/products/search` for keyword-based product discovery with pagination.
- **Scheduled Monitoring** — `PUT /v1/products/scheduled` to set hourly, daily, or weekly refresh cadences for tracked products.
- **API Playground demo mode** — Try all endpoints with sample Sony WH-1000XM5 data, no credits consumed.
- **Live mode playground** — Test with your real API key, see actual product data and credit deductions.
### Changed
- **Improved product matching** — Better handling of model numbers and URLs as identifiers, faster ASIN lookups.
---
## 2026-02-28
### Added
- **CSV export** — `?format=csv` on `/products` and `/products/offers` endpoints for spreadsheet compatibility.
- **Single retailer filtering** — `?retailer=amazon.com` on offers endpoint to get prices from one retailer only.
- **Usage endpoint** — `GET /v1/usage` returns current billing period credits used, remaining, and request count.
### Fixed
- **Price history date validation** — Better error messages when date format is invalid.
- **Offer deduplication** — Removed duplicate offers from the same retailer in response data.
---
## 2026-02-15
### Added
- **Developer Dashboard** — Usage analytics, API key management, subscription billing, and onboarding progress tracker.
- **Stripe integration** — Subscribe to Starter ($49/mo), Professional ($199/mo), or Enterprise ($499/mo) plans with 14-day free trial on Starter.
- **API key management** — Create up to 5 API keys per account, revoke keys, see last-used timestamps.
- **Grandfathered free tier** — Legacy users receive 50 credits/month perpetually.
---
## 2026-01-30
### Added
- **Initial API launch** — Product Lookup, All Retailer Prices, and Price History endpoints.
- **API key authentication** — Bearer token auth with `ss_live_` prefixed keys, SHA-256 hashed storage.
- **Credit-based billing** — 1 credit per product lookup, 3 per all-retailer offers, 2 per single-retailer, 1 per day of history.
- **Rate limiting** — 100 requests/minute for authenticated users, 10/minute for anonymous MCP access.
- **10 official SDKs** — TypeScript, Python, Go, Ruby, Java, PHP, C#, Rust, Swift, Kotlin. Available on npm, PyPI, pkg.go.dev, RubyGems, Maven, Packagist, NuGet, crates.io, Swift Package Manager, and Maven Central.
- **MCP Server integration** — Model Context Protocol server for AI assistants (Claude, Cursor, etc.) with anonymous rate-limited access.
---
# Universal Product Search API
> The world's most comprehensive product database
*Source: https://shopsavvy.com/search-api*
---
## Hero
**Badge:** Enterprise API
Search millions of products across 70,000+ retailers. Real-time pricing and availability. Built on 16+ years of price comparison expertise.
**CTA:** Contact Us for Enterprise Access
---
## Stats
| Stat | Label |
|------|-------|
| 70K+ | Retailers |
| 16+ | Years of Data |
| Real-Time | Pricing |
| 99.9% | Uptime |
---
## Comprehensive Product Coverage
One API to search every product, everywhere
### Physical Products
Electronics, appliances, furniture, tools, toys, clothing, and everything in between. In-store and online inventory across all major retailers.
- Major retail chains
- Grocery and household
- Specialty and niche stores
### Digital Products
Music, movies, TV shows, video games, eBooks, and audiobooks. All major digital storefronts and streaming platforms.
- Streaming services
- Digital downloads
- Gaming platforms
### Price Comparison
The same product matched across multiple retailers. See every price option instantly and find the best deal.
- Cross-retailer matching
- Real-time price updates
- Historical price data
### All Seller Types
First-party retailers, third-party marketplaces, and independent merchants. Complete market visibility.
- Direct retailers
- Marketplace sellers
- Independent stores
---
## Built for Enterprise
Production-ready features for scale and reliability
### Blazing Fast
Get comprehensive results in seconds. Our infrastructure is optimized for speed at any scale.
### Real-Time Data
Prices and availability that reflect what's actually in stores right now. No stale data.
### Smart Matching
The same product automatically matched across retailers. Know exactly who has the best price.
### Streaming Results
Results delivered progressively as they're ready. Build responsive UIs that feel instant.
### AI Summaries
Optional AI-generated shopping recommendations. Help users decide faster with smart insights.
### Flexible Limits
Rate limits tailored to your needs. From thousands to millions of requests per month.
---
## Simple Integration
Clean REST API with JSON responses
### Request
```
POST /enterprise/api/v1/search
Authorization: Bearer ss_live_your_api_key
{
"query": "macbook pro 16 inch",
"limit": 20
}
```
### Response
```json
{
"success": true,
"data": {
"query": "macbook pro 16 inch",
"products": [
{
"title": "MacBook Pro 16-inch M3 Pro",
"price_cents": 249900,
"retailer_name": "Best Buy",
"url": "https://...",
"in_stock": true,
"other_retailers": [
{ "name": "Amazon", "price_cents": 249900 },
{ "name": "Walmart", "price_cents": 249999 }
]
}
// ... more products
],
"metadata": {
"total_results": 47,
"timing_ms": 892
}
}
}
```
---
## Use Cases
Power your products with comprehensive product data
### AI Shopping Assistants
Build conversational shopping experiences with real-time product data. Give your AI access to current prices and availability across all retailers.
### Price Comparison Apps
Show users the best price on any product, instantly. Complete market visibility with a single API call.
### Market Research
Track pricing trends, product availability, and competitive positioning. Build comprehensive market intelligence dashboards.
### E-commerce Enrichment
Enrich your product catalog with competitive pricing data. Power shopping recommendations with real market data.
---
## Enterprise Support
Dedicated support for production deployments
### Dedicated Support
Direct line to our engineering team
### SLA Guarantees
Uptime and response time commitments
### Custom Integrations
Tailored to your specific needs
### Volume Pricing
Competitive rates at scale
---
## CTA
**Ready to get started?**
Contact our enterprise team to discuss your requirements
**CTA:** Contact Our Enterprise Team
---
# Bulk Data Licensing
> Power your analytics, AI models, and market research with comprehensive retail data
*Source: https://shopsavvy.com/data-licensing*
---
## Hero
Power your analytics, AI models, and market research with comprehensive retail data spanning tens of thousands of retailers
**CTA:** Contact Our Data Team
---
## Intro
Since 2008, ShopSavvy has been collecting and organizing retail data from across the web. Our database contains extensive product information, real-time pricing from a vast network of retailers, and years of historical price data. All available through annual licensing agreements tailored to your specific needs.
---
## Product Catalog Data
Comprehensive product information aggregated from multiple sources
### Product Identifiers
- UPC / Barcode
- Manufacturer Part Number (MPN)
- Stock Keeping Unit (SKU)
- Retailer-specific IDs (ASIN, etc.)
### Basic Information
- Product titles (original and normalized)
- Brand names
- Model numbers
- Color variants
- Category hierarchies
### Rich Content
- Full product descriptions
- Product specifications and attributes
- Feature lists
- Package contents
### Product Images
- Primary product images
- Multiple image variants
- High-resolution URLs
### Ratings & Reviews
- Aggregated ratings from multiple retailers
- Rating values (out of 5)
- Review counts
- Star distribution breakdown
### Comparisons
- Related products
- Similar alternatives
- Comparison data
- Accessory relationships
---
## Pricing & Offer Data
Real-time pricing intelligence from a vast network of online and brick-and-mortar retailers
### Price Information
- Current retail prices
- MSRP / List prices
- Sale prices
- Strikethrough / Original prices
- Multi-currency support
### Availability Status
- In-stock indicators
- Out-of-stock tracking
- Pre-order availability
- Backorder status
### Product Condition
- New
- Used
- Refurbished
- Open-box
- Certified pre-owned
### Retailer Information
- Retailer names and identifiers
- Trust indicators
- Retailer ratings
- Direct product URLs
### Marketplace Data
- Third-party seller information
- Seller ratings and reviews
- Buy Box status
- Auction listings
### Local Store Data
- Brick-and-mortar locations
- Store addresses
- Geographic coordinates
- Local pickup availability
---
## Historical Price Data
Years of price tracking data for trend analysis and predictive modeling
### Price Snapshots
- Every price change recorded
- Timestamped data points
- Multiple snapshots per day
- Full audit trail
### Trend Data
- Years of historical pricing
- Seasonal patterns
- Sale event tracking
- Price volatility metrics
### Availability History
- Stock level changes over time
- Out-of-stock duration tracking
- Restock patterns
- Inventory trends
### Multi-Retailer Coverage
- Historical data across competing retailers
- Price comparison over time
- Market position tracking
- Competitive analysis data
---
## Flexible Delivery Formats
Get your data in the format that works best for your infrastructure
| Format | Type |
|--------|------|
| JSON | Structured |
| JSONL | Streaming |
| CSV | Tabular |
| XML | Enterprise |
| Parquet | Analytics |
| Avro | Compact |
Need a different format? We can accommodate custom formats upon request.
---
## Common Use Cases
Our data powers a wide range of applications across industries
### AI & Machine Learning
Train models on real-world retail data for price prediction, demand forecasting, and product classification.
### Price Intelligence
Monitor competitor pricing, identify market trends, and optimize your pricing strategy with historical data.
### Market Research
Analyze product availability, pricing patterns, and market dynamics across thousands of retailers.
### Academic Research
Study consumer behavior, e-commerce trends, and retail economics with comprehensive historical data.
### Investment Analysis
Track retail performance, identify market shifts, and inform investment decisions with real-world data.
### Demand Forecasting
Predict inventory needs, plan purchasing, and optimize supply chain with historical trend data.
---
## Enterprise-Ready
Flexible licensing options designed for enterprise needs
- Annual licensing agreements
- Custom data scopes and filters
- Scheduled delivery (daily, weekly, monthly)
- Incremental updates or full snapshots
- Dedicated support
- Custom SLAs available
- Volume-based pricing
- Secure data transfer
- Custom contract terms
---
## CTA
**Ready to Get Started?**
Contact our data team to discuss your specific requirements and get a custom quote tailored to your needs.
**CTA:** Contact Our Data Team
**Email:** business@shopsavvy.com
---
# ShopSavvy for Business
> Professional price tracking and competitive intelligence for e-commerce businesses
*Source: https://shopsavvy.com/business*
---
## Hero
**ShopSavvy for Business**
Professional price tracking and competitive intelligence for e-commerce businesses
Monitor competitor prices across thousands of retailers, track product availability, and automate your pricing strategy with powerful analytics.
- [Start Free Trial](#pricing)
- [View Pricing](#pricing)
---
## Features
**Everything you need to stay ahead of the competition**
### Real-Time Price Tracking
Monitor competitor prices with up to hourly updates. Get alerts when prices change so you can adjust your strategy.
### Historical Analytics
Analyze competitor price trends over time with detailed charts. Identify seasonal patterns and optimize your pricing strategy.
### Bulk Operations
Import your entire product catalog via CSV. Update settings in bulk. Export data for analysis in your existing tools.
### Smart Alerts
Get notified via email or web push when competitor prices change, stock levels shift, or market conditions move.
### Multi-Retailer Coverage
Track competitor prices across thousands of retailers including Amazon, Walmart, Target, Best Buy, and more.
### Local Store Price Tracking
Track brick-and-mortar store prices and availability by location. Monitor regional pricing variations across physical retail.
---
## Feature Showcase
### Your Competitive Intelligence Dashboard
Monitor your entire product catalog from one central hub. Track competitor price movements in real-time, see market coverage across retailers, and identify pricing opportunities before your competition does.
### Historical Pricing Analytics
Analyze competitor pricing strategies over time. Identify seasonal patterns, promotional cycles, and market trends. Use historical data to forecast competitor behavior and optimize your own pricing strategy.
### Multi-Retailer Price Benchmarking
Benchmark your prices against every competitor simultaneously. Track current prices, historical averages, and price volatility by retailer. Understand who is undercutting the market and by how much.
### Individual Marketplace Seller Tracking
Track individual third-party sellers across Amazon, Walmart, eBay, and other major marketplaces. See exactly who is selling what, at what price, and how their pricing changes over time.
### Regional Pricing Intelligence
Monitor brick-and-mortar pricing by geographic location. Understand regional price variations, track in-store vs. online pricing gaps, and identify market-specific competitive dynamics.
### Inventory & Availability Tracking
Monitor competitor stock levels across channels. Identify supply chain disruptions, track out-of-stock rates, and spot market opportunities when competitors run low on inventory.
### Market Sentiment Analysis
Aggregate professional reviews and customer feedback across the market. Understand product positioning, identify competitive weaknesses, and track how market perception evolves over time.
### Enterprise-Ready Bulk Import
Onboard your product catalog quickly. Upload CSV, TSV, or Excel files and our AI automatically maps your columns. Scale from dozens to hundreds of SKUs based on your plan.
---
## Pricing
**Simple, transparent pricing**
Start with a 14-day free trial. Cancel anytime.
### Starter — $99.99/month
*Perfect for small businesses tracking a handful of products*
Up to 50 products
**Features included:**
- Track up to 50 products
- Daily price updates
- Price history charts
- Email alerts
- Web push notifications
- Bulk operations
- CSV import/export
**Update frequency:** Daily, Weekly, Manual
### Growth — $249.99/month *(Most Popular)*
*For growing businesses with expanding product catalogs*
Up to 150 products
**Features included:**
- Track up to 150 products
- 4-hour price updates
- Price history charts
- Email & push alerts
- Bulk operations
- CSV import/export
**Update frequency:** 4 hours, 12 hours, Daily, Weekly
### Professional — $499.99/month
*For businesses tracking up to 300 products with hourly updates*
Up to 300 products
**Features included:**
- Track up to 300 products
- Hourly price updates
- Unlimited price history
- Priority support
- Email & push alerts
- Bulk operations
- CSV import/export
- Custom integrations
**Update frequency:** Hourly, 4 hours, 12 hours, Daily, Weekly
### Enterprise — Custom Pricing
*For large organizations tracking 300+ products*
Custom product limits
**Enterprise features:**
- Custom product limits
- Custom refresh frequencies
- Dedicated account manager
- SLA guarantees
- Custom API integrations
- Volume discounts
- Priority support
- White-label options
- Custom contract terms
**Update frequency:** Custom
**Perfect for:** Large retailers, enterprises, and agencies tracking hundreds or thousands of products
[Contact Sales](mailto:business@shopsavvy.com?subject=Enterprise%20Plan%20Inquiry)
All plans include 14-day free trial. Cancel anytime.
---
## Frequently Asked Questions
**Everything you need to know about ShopSavvy for Business**
### How does the 14-day free trial work?
Start tracking products immediately with full access to all features during your 14-day free trial. After the trial, continue with a paid plan or cancel anytime with no charges.
### What happens if I exceed my product limit?
You'll be prompted to upgrade to a higher tier plan. Existing tracked products continue updating, but you won't be able to add new ones until you upgrade or remove some products.
### How often are prices updated?
You can choose the refresh frequency per product: hourly, daily, or weekly. Higher-tier plans get access to more frequent updates. All price changes trigger immediate notifications.
### Can I import my existing product list?
Yes! Upload a CSV file with product URLs, ASINs, barcodes, or model numbers. Our AI automatically detects the columns and imports everything. You can also export your data anytime.
### Which retailers do you support?
We track prices across thousands of retailers including Amazon, Walmart, Target, Best Buy, Home Depot, Lowe's, and many more. If a retailer sells a product online, we can track it.
### Can I cancel anytime?
Absolutely. Cancel anytime from your subscription settings. Your data remains accessible until the end of your billing period, and you can export everything before you go.
---
## Cross-Promo
**Need programmatic access?**
The ShopSavvy Data API provides direct access to our price comparison data (separate subscription). [Learn More](/data)
---
## CTA
**Ready to gain a competitive edge?**
Join businesses using ShopSavvy for Business to stay ahead of the competition.
[Start Your Free Trial](#pricing)
---
# ShopSavvy Integrations
Official SDKs, plugins, and tools that connect the ShopSavvy Data API to your favorite platforms. Search products, compare prices across thousands of retailers, track price history, and discover deals from anywhere.
## SDKs
Official client libraries in 10 languages:
- **Python SDK** — `pip install shopsavvy-sdk` — [GitHub](https://github.com/shopsavvy/sdk-python) | [PyPI](https://pypi.org/project/shopsavvy-sdk/)
- **TypeScript SDK** — `npm install @shopsavvy/sdk` — [GitHub](https://github.com/shopsavvy/sdk-typescript) | [npm](https://www.npmjs.com/package/@shopsavvy/sdk)
- **Swift SDK** — Swift Package Manager — [GitHub](https://github.com/shopsavvy/sdk-swift)
- **Kotlin SDK** — Gradle/Maven — [GitHub](https://github.com/shopsavvy/sdk-kotlin)
- **Go SDK** — `go get github.com/shopsavvy/sdk-go` — [GitHub](https://github.com/shopsavvy/sdk-go)
- **Rust SDK** — `cargo add shopsavvy-sdk` — [GitHub](https://github.com/shopsavvy/sdk-rust) | [crates.io](https://crates.io/crates/shopsavvy-sdk)
- **Ruby SDK** — `gem install shopsavvy-sdk` — [GitHub](https://github.com/shopsavvy/sdk-ruby) | [RubyGems](https://rubygems.org/gems/shopsavvy-sdk)
- **PHP SDK** — `composer require shopsavvy/shopsavvy-sdk-php` — [GitHub](https://github.com/shopsavvy/sdk-php)
- **Java SDK** — Maven Central — [GitHub](https://github.com/shopsavvy/sdk-java)
- **C# SDK** — `dotnet add package ShopSavvy.Sdk` — [GitHub](https://github.com/shopsavvy/sdk-csharp) | [NuGet](https://www.nuget.org/packages/ShopSavvy.Sdk)
## AI Agent Integrations
- **MCP Server** — Give any AI assistant (Claude, ChatGPT, Gemini) access to product and pricing data — [GitHub](https://github.com/shopsavvy/shopsavvy-mcp-server)
- **LangChain** — Tools for product search, price comparison, and price history in LangChain agents — [GitHub](https://github.com/langchain-ai/langchain/pull/36415)
- **LlamaIndex** — Tool spec for product data retrieval in LlamaIndex agents — [GitHub](https://github.com/shopsavvy/llamaindex-shopsavvy)
- **Dify** — Plugin for product search and price comparison in Dify workflows — [GitHub](https://github.com/langgenius/dify-official-plugins/pull/2816)
- **crewAI** — Tool for multi-agent product research — [GitHub](https://github.com/crewAIInc/crewAI/pull/5159)
- **Haystack** — Components for product search and price comparison in Haystack pipelines — [GitHub](https://github.com/deepset-ai/haystack-core-integrations/pull/3073)
- **Langflow** — Visual components for Langflow workflows — [GitHub](https://github.com/langflow-ai/langflow/pull/12431)
## Workflow Automation
- **n8n** — Community node for product search, pricing, and price history in n8n workflows — [GitHub](https://github.com/shopsavvy/n8n-nodes-shopsavvy)
- **Zapier** — Triggers, searches, and actions for Zapier automations — [GitHub](https://github.com/shopsavvy/zapier-shopsavvy)
- **Activepieces** — Piece for product data and price monitoring in Activepieces — [GitHub](https://github.com/activepieces/activepieces/pull/12323)
- **Huginn** — Ruby agents for product lookup, price monitoring, and deal discovery — [GitHub](https://github.com/shopsavvy/huginn-shopsavvy-agent)
## Developer Tools
- **CLI** — Price comparison from your terminal — `brew tap shopsavvy/shopsavvy && brew install shopsavvy` — [GitHub](https://github.com/shopsavvy/shopsavvy-cli)
- **GitHub Action** — Check product prices in CI/CD workflows — [GitHub](https://github.com/shopsavvy/github-action-shopsavvy)
- **Raycast** — Search products and compare prices from Raycast — [GitHub](https://github.com/shopsavvy/raycast-shopsavvy)
- **Alfred** — Product search and price comparison from Alfred — [GitHub](https://github.com/shopsavvy/alfred-shopsavvy)
- **Docker** — Run the ShopSavvy CLI in a container — [GitHub](https://github.com/shopsavvy/docker-shopsavvy-cli)
- **Homebrew** — Install the CLI with Homebrew — [GitHub](https://github.com/shopsavvy/homebrew-shopsavvy)
## E-Commerce
- **Shopify** — Competitor price intelligence for Shopify merchants — [GitHub](https://github.com/shopsavvy/shopify-shopsavvy)
- **WooCommerce** — Show competitor prices on WooCommerce product pages — [GitHub](https://github.com/shopsavvy/woocommerce-shopsavvy)
- **WordPress** — Price comparison block, shortcode, and widget for WordPress — [GitHub](https://github.com/shopsavvy/wordpress-shopsavvy)
## Serverless Templates
- **Cloudflare Workers** — Edge-deployed price comparison API — [GitHub](https://github.com/shopsavvy/cloudflare-worker-shopsavvy)
- **Vercel Edge** — Next.js App Router API routes with edge runtime — [GitHub](https://github.com/shopsavvy/vercel-edge-shopsavvy)
- **AWS Lambda** — SAM template with API Gateway + scheduled price monitoring — [GitHub](https://github.com/shopsavvy/aws-lambda-shopsavvy)
- **Supabase Edge Functions** — Three Deno edge functions for product data — [GitHub](https://github.com/shopsavvy/supabase-shopsavvy)
- **Deno Deploy** — Hono router template for product search and pricing — [GitHub](https://github.com/shopsavvy/deno-deploy-shopsavvy)
## Additional AI Frameworks
- **AutoGen** — Async-first tools for Microsoft AutoGen multi-agent systems — [GitHub](https://github.com/shopsavvy/autogen-shopsavvy)
- **Semantic Kernel** — C# plugin with [KernelFunction] attributes — [GitHub](https://github.com/shopsavvy/semantic-kernel-shopsavvy)
- **Vercel AI SDK** — tool() definitions with Zod schemas — [GitHub](https://github.com/shopsavvy/vercel-ai-shopsavvy)
- **OpenAI Functions** — JSON schemas + Python/TypeScript examples for function calling — [GitHub](https://github.com/shopsavvy/openai-shopsavvy-function)
## Chat Bots
- **Telegram Bot** — Search products, compare prices, browse deals from Telegram — [GitHub](https://github.com/shopsavvy/telegram-shopsavvy-bot)
- **Discord Bot** — Slash commands with rich embeds for product search and pricing — [GitHub](https://github.com/shopsavvy/discord-shopsavvy-bot)
- **Slack App** — Block Kit formatted product cards and deal discovery — [GitHub](https://github.com/shopsavvy/slack-shopsavvy)
- **Matrix Bot** — Product search and pricing in Matrix/Element rooms — [GitHub](https://github.com/shopsavvy/matrix-shopsavvy-bot)
- **Mastodon Bot** — Auto-post deals, respond to price check mentions — [GitHub](https://github.com/shopsavvy/mastodon-shopsavvy-bot)
- **Bluesky** — Reactive mention bot, custom deals feed generator, and daily poster on AT Protocol — [GitHub](https://github.com/shopsavvy/bluesky-shopsavvy)
## Web Frameworks
- **Django** — Template tags, DRF viewset, middleware, model mixin, and management commands — `pip install django-shopsavvy` — [GitHub](https://github.com/shopsavvy/django-shopsavvy)
- **Laravel** — Facade, Blade components, Artisan commands, and optional API routes — `composer require shopsavvy/laravel-shopsavvy` — [GitHub](https://github.com/shopsavvy/laravel-shopsavvy)
- **Hono** — Edge-native middleware, router, JSX components, SSE streaming, RPC across CF/Vercel/Bun/Node/Deno — `npm install @shopsavvy/hono` — [GitHub](https://github.com/shopsavvy/hono-shopsavvy)
- **Astro** — Content Loader, zero-JS components, islands, RSS + sitemap helpers — `npm install astro-shopsavvy` — [GitHub](https://github.com/shopsavvy/astro-shopsavvy)
- **FastAPI** — Dependency injection and pre-built router for Python APIs — `pip install fastapi-shopsavvy` — [GitHub](https://github.com/shopsavvy/fastapi-shopsavvy)
- **Express.js** — Middleware and router for Express apps — `npm install express-shopsavvy` — [GitHub](https://github.com/shopsavvy/express-shopsavvy)
- **NestJS** — Injectable module for NestJS apps — `npm install nestjs-shopsavvy` — [GitHub](https://github.com/shopsavvy/nestjs-shopsavvy)
## Mobile UI
- **React Native** — Hooks for product search, price comparison, deals — `npm install react-native-shopsavvy` — [GitHub](https://github.com/shopsavvy/react-native-shopsavvy)
- **Flutter** — Dart SDK with Material widgets for product cards and pricing — [GitHub](https://github.com/shopsavvy/flutter-shopsavvy)
- **SwiftUI** — SwiftUI views and @Observable view models — [GitHub](https://github.com/shopsavvy/swiftui-shopsavvy)
- **Jetpack Compose** — Material 3 composables with StateFlow view models — [GitHub](https://github.com/shopsavvy/jetpack-compose-shopsavvy)
## Productivity
- **Obsidian** — Product data blocks and price comparisons in your vault — [GitHub](https://github.com/shopsavvy/obsidian-shopsavvy)
- **VS Code** — ASIN hover previews, product search, price check panel — [GitHub](https://github.com/shopsavvy/vscode-shopsavvy)
- **Logseq** — Slash commands and live product card blocks — [GitHub](https://github.com/shopsavvy/logseq-shopsavvy)
- **JetBrains IDEs** — Tool window and actions for IntelliJ, WebStorm, PyCharm — [GitHub](https://github.com/shopsavvy/jetbrains-shopsavvy)
- **Notion** — Product tracking database with live pricing in your Notion workspace — [GitHub](https://github.com/shopsavvy/notion-shopsavvy)
- **Raycast** — 9 commands, 2 AI tools, and live menu-bar price tracker for Mac power users — [GitHub](https://github.com/shopsavvy/raycast-shopsavvy)
## Home Automation
- **Home Assistant** — Price monitoring sensors with HACS support — [GitHub](https://github.com/shopsavvy/homeassistant-shopsavvy)
- **Homebridge** — ContactSensor accessories triggered by price drops — [GitHub](https://github.com/shopsavvy/homebridge-shopsavvy)
## Data & Analytics
- **Jupyter** — Magic commands for product search and pricing in notebooks — `pip install jupyter-shopsavvy` — [GitHub](https://github.com/shopsavvy/jupyter-shopsavvy)
- **Pandas** — DataFrame accessor for enriching data with pricing — `pip install pandas-shopsavvy` — [GitHub](https://github.com/shopsavvy/pandas-shopsavvy)
- **Streamlit** — Drop-in components for product data dashboards — `pip install streamlit-shopsavvy` — [GitHub](https://github.com/shopsavvy/streamlit-shopsavvy)
- **Google Sheets** — =SHOPSAVVY_PRICE() and =SHOPSAVVY_SEARCH() custom functions — [GitHub](https://github.com/shopsavvy/google-sheets-shopsavvy)
- **Excel** — Custom functions and task pane for Microsoft Excel — [GitHub](https://github.com/shopsavvy/excel-shopsavvy)
- **Gradio** — Product search, price comparison charts, and price history for Gradio apps — `pip install gradio-shopsavvy` — [GitHub](https://github.com/shopsavvy/gradio-shopsavvy)
- **Apache Airflow** — Operators, hooks, and sensors for price data ETL pipelines — `pip install airflow-provider-shopsavvy` — [GitHub](https://github.com/shopsavvy/airflow-provider-shopsavvy)
- **Grafana** — Data source plugin for competitive price monitoring with 6 query types + example dashboards — [GitHub](https://github.com/shopsavvy/grafana-shopsavvy-datasource)
## Voice Assistants
- **Amazon Alexa** — Voice-first price intelligence Skill with APL visuals for Echo Show — [GitHub](https://github.com/shopsavvy/alexa-shopsavvy-skill)
- **Apple Shortcuts** — 8 App Intents for Siri voice, Share Sheet, and Shortcuts app — [GitHub](https://github.com/shopsavvy/shortcuts-shopsavvy)
## Notifications & Bridges
- **RSS Feed** — RSS 2.0 and Atom feeds of deals and price drops — [GitHub](https://github.com/shopsavvy/shopsavvy-rss)
- **Webhooks** — HMAC-signed webhook relay for price change events — [GitHub](https://github.com/shopsavvy/shopsavvy-webhooks)
- **MQTT Bridge** — Publish price data to MQTT topics with HA discovery — [GitHub](https://github.com/shopsavvy/shopsavvy-mqtt)
- **ntfy** — Price drop push notifications via ntfy.sh — [GitHub](https://github.com/shopsavvy/ntfy-shopsavvy)
## Getting Started
All integrations are powered by the [ShopSavvy Data API](https://shopsavvy.com/data). Get your API key at [shopsavvy.com/data](https://shopsavvy.com/data) to start using any integration.
Full API documentation: [shopsavvy.com/data/documentation](https://shopsavvy.com/data/documentation)
---
# ShopSavvy — Never Overpay for Anything
Trusted by 40M+ shoppers since 2008.
ShopSavvy compares prices across thousands of retailers, tracks price history, and alerts you the moment something drops. On your phone, in your browser, or on your desktop.
## Platform
### Mobile App
Scan barcodes, search products, track prices, and get alerts. Available free on iOS and Android with 40M+ downloads.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension
Automatic price comparisons on any product page. See price history charts, find better deals, and set alerts without leaving the store.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App
A full shopping assistant powered by Claude. Auto-buy at target prices, call stores to negotiate, and monitor deals in the background.
- [Learn more](/desktop)
## Core Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **See the full price history** — Know whether today's price is actually a deal
- **Get alerted when prices drop** — Set a target price and get notified
- **Know when it's back in stock** — Alerts when sold-out items return
## For Developers & AI
- **[MCP Server](/agents)** — Free, open source. Give any AI assistant access to product lookups, pricing, and deal discovery.
- **[Data API](/data)** — REST API with SDKs in 10 languages for product data, pricing, and availability.
- **[Search API](/search-api)** — Enterprise-grade universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, GitHub Copilot, and Cursor.
## For Business
Competitive price monitoring, automated. Track competitor prices, get alerts, monitor availability, export data.
- [Explore Business Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated product recommendations
- [TLDR Reviews](/reviews-tldr) — Concise product reviews
- [Gift Guides](/gift-guides) — Find the perfect gift
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, and events
- [Expert Q&A](/answers) — Answers to real shopping questions
- [Blog](/blog) — Tips, news, and insights
## By the Numbers
- 40M+ downloads across iOS & Android
- 100M+ products in our database
- 40,000+ retailers monitored daily
- Founded in 2008
## As Featured In
- The Washington Post: "A secret weapon for bargain hunters"
- The New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for bargain hunters"
- TechCrunch: "One of the best early applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# ShopSavvy — Shop Smarter, Save More
40 million downloads. Since 2008.
Compare prices across thousands of retailers, track price history, and get alerts when prices drop. Free on every platform.
## Features
- **Compare prices everywhere** — Search by name, barcode, or photo across thousands of retailers
- **Full price history** — See if today's "sale" is actually a deal
- **Price drop alerts** — Set a target price and get notified the moment it drops
- **Back-in-stock alerts** — We'll watch sold-out items and tell you when they're available
- **Private by default** — No personal data collected, no shopping habits shared
## Platforms
### Mobile App (iOS & Android)
Scan barcodes, compare prices, track products, and get push notifications.
- [Get for iPhone or iPad](https://shopsavvy.com/link/81nF)
- [Get for Android](https://shopsavvy.com/link/hJJ9)
- [Learn more](/app)
### Browser Extension (Chrome, Edge, Safari)
Automatic price comparisons and history on every product page you visit.
- [Get for Chrome](https://shopsavvy.com/link/chrome)
- [Get for Edge](https://shopsavvy.com/link/edge)
- [Get for Safari](https://shopsavvy.com/link/safari)
- [Learn more](/browser-extension)
### Desktop App (Mac & Windows)
A full shopping assistant that can auto-buy, call stores, and monitor prices in the background.
- [Learn more](/desktop)
## By the Numbers
- 40M+ downloads
- 100M+ products tracked
- 40,000+ retailers
- 18 years running
## For Developers & AI
- [MCP Server](/agents) — Give any AI assistant shopping superpowers. Free & open source.
- [Data API](/data) — REST API with SDKs in 10 languages.
- [Search API](/search-api) — Universal product search across all retailers.
Works with Claude, ChatGPT, Gemini, Copilot, Cursor.
## For Business
Competitive price monitoring — track competitors, get alerts, export data.
- [Explore Plans](/business)
- [Bulk Data Licensing](/data-licensing)
## Expert Shopping Resources
- [Best Picks](/best-picks) — Expert-curated recommendations
- [TLDR Reviews](/reviews-tldr) — Concise reviews with verdict
- [Gift Guides](/gift-guides) — Perfect gifts for anyone
- [Best Time to Buy](/best-time-to-buy) — Know when prices are lowest
- [Product News](/news) — Releases, recalls, events
- [Expert Q&A](/answers) — Real answers backed by data
- [Blog](/blog) — Tips, news, insights
## Our Values
- Results sorted by price. Always. No one can pay to rank higher.
- Your data stays yours. No personal info collected.
- Free. No catch. 40M+ people use ShopSavvy without paying a cent.
## Press
- Washington Post: "A secret weapon for bargain hunters"
- New York Times: "I've relied mostly on the ShopSavvy app"
- TIME: "A must-have for professional bargain hunters"
- TechCrunch: "One of the best early Android applications"
---
# Advertise on ShopSavvy
ShopSavvy users come here ready to buy. They're comparing prices and looking for deals at the moment of purchase intent. Get your deal or brand in front of them.
## Packages
### Promoted — $1,000/week
A featured deal card at the top of the deal feed.
- Top-of-feed placement on mobile app, website, and browser extension
- Looks like a regular deal card (native feel, no intrusive ads)
- Full deal detail page with impression and click tracking
- Fastest way to get in front of active shoppers
### Spotlight — $2,500/week
Premium banner placement.
- Fixed banner across every page of the website
- Shown on the mobile app and browser extension
- Always visible while users scroll
- Custom CTA button with your link
- Brand-forward awareness placement
### Full Reach — $4,000/week
Everything bundled.
- Promoted deal card + Spotlight banner
- Featured mention in the daily deals email
- Maximum reach across every ShopSavvy surface
- Best for product launches and big pushes
- Save versus buying packages separately
## Reach
- 40M+ total app downloads across iOS and Android
- 155K+ monthly website visits
- High-intent shoppers at the moment of purchase
- Three platforms: web, mobile app, browser extension
## How It Works
1. Pick a package
2. Fill out your deal or banner content with a live preview
3. Select your week
4. Pay via Stripe
5. Promoted deals go through an automated content review before going live (usually a few minutes after payment). Spotlight banners go live on your selected week's start date.
## Questions?
Email business@shopsavvy.com
---
# Affiliate & Editorial Disclosure
*Last updated April 2026*
ShopSavvy is committed to transparency. This page explains how we make money, our relationships with retailers, and how we choose which products and deals to feature.
## Amazon Associates Disclosure
ShopSavvy is a participant in the Amazon Services LLC Associates Program, an affiliate advertising program designed to provide a means for sites to earn advertising fees by advertising and linking to Amazon.com.
As an Amazon Associate, we earn from qualifying purchases. This means when you click on a link to Amazon on our site or app and make a purchase, we may receive a small commission at no additional cost to you.
Amazon and the Amazon logo are trademarks of Amazon.com, Inc. or its affiliates.
## Affiliate Relationships
ShopSavvy has affiliate relationships with many online retailers. When you click on links to these retailers through our website, mobile apps, browser extensions, or desktop app and make a purchase, we may earn a commission.
We participate in affiliate programs through the following networks, which connect us with retailers across electronics, home goods, fashion, beauty, and many other categories:
- **Amazon Associates** — direct affiliate program with Amazon.com and its international marketplaces
- **Skimlinks** — covers thousands of merchants across categories
- **Sovrn Commerce (Viglink)** — covers thousands of merchants
- **Impact** — direct programs with Walmart, Levi's, Crocs, Cabela's, Moosejaw, and others
- **Rakuten Advertising (LinkShare)** — direct programs with Best Buy and others
- **Connexity** — CPC-based program across major merchants
- **FlexOffers** — direct programs with Adorama, Acer, AT&T, Best Buy, Dell, HP, Lenovo, Lowe's, JCPenney, and others
- **Commission Junction (CJ)** — selected merchant programs
- **Partnerize** — selected merchant programs
- **eBay Partner Network** — direct affiliate program with eBay.com
**Important:** The presence of affiliate links does not influence our product rankings or recommendations. We always sort results by price, and no retailer can pay us to appear higher in our results.
## Advertiser Disclosure
Some of the offers that appear on ShopSavvy are from companies from which we receive compensation.
However, this compensation does not influence our core price comparison functionality. When you search for a product, results are always sorted by price. We work for you, the consumer, not the retailers.
## Editorial Policy
Our editorial content, including buying guides, product reviews, and deal recommendations, is created independently of our business relationships.
### How We Choose Products to Feature
- **Price:** We prioritize products that offer genuine value and significant savings.
- **Quality:** We consider product ratings, reviews, and reputation when making recommendations.
- **Relevance:** We focus on products that our users are actively searching for and interested in.
### Our Commitment
Since 2008, ShopSavvy has been committed to helping shoppers find the best deals. Our mission is simple: empower everyone to always get the best deal, every time.
We believe shopping should be a level playing field. No games, just the facts. Retailers cannot pay us to display their products above competitors in our price comparison results.
Our editorial team maintains full independence in deciding what products to review and recommend. Affiliate relationships do not influence our editorial judgment.
## User-Submitted Deals
ShopSavvy features deals submitted by our community. These deals are voted on by users and sorted using a decay algorithm that surfaces the most popular recent deals.
User-submitted deals may contain affiliate links. When you purchase through these links, we may earn a commission. This helps support the platform and keeps ShopSavvy free for everyone.
## Questions?
If you have any questions about our affiliate relationships, advertising practices, or editorial policies, please contact us:
Email: support@shopsavvy.com
Monolith Technologies Inc