ShopSavvy for Amazon Alexa

TypeScript

An Alexa Skill for voice-first product research. Ask for fair prices, check deal quality, hear price history, and manage a watchlist — all via Siri-style voice commands. APL visual cards on Echo Show devices.

View on GitHub Get Your API Key

Set up ShopSavvy for Amazon Alexa

1
Get a ShopSavvy Data API key
Create a key at shopsavvy.com/data. Keys look like ss_live_ followed by 32 characters. Keep it out of source control.
2
Install
Get the integration from its repository and follow the README's install section: https://github.com/shopsavvy/alexa-shopsavvy-skill
```
git clone https://github.com/shopsavvy/alexa-shopsavvy-skill.git
```
3
Add your API key
Set the SHOPSAVVY_API_KEY environment variable to your key (shell, .env file or Amazon Alexa's secrets settings), or pass it to the client as the README shows.
4
Make your first call
From the shopsavvy/alexa-shopsavvy-skill README (1. Install dependencies):
```
cd lambda
npm install
```
Copied from the repository README.
5
2. Configure environment
From the shopsavvy/alexa-shopsavvy-skill README (2. Configure environment):
```
cp .env.example .env
# Edit .env and set SHOPSAVVY_API_KEY
```
Copied from the repository README.

Keys come with a Data API plan. See plans.

Features

PriceCheck, IsFairPrice, PriceHistory intents

DealAlert and MyWatchlist (with account linking)

DealOfTheDay for trending deals by category

APL visual documents for Echo Show (5", 8", 10")

Multi-turn dialogue with session attributes

Built on ASK SDK + AWS Lambda

Use Cases

1."Alexa, ask ShopSavvy for the best price on AirPods Pro"

2."Is $1,200 fair for a MacBook Air?"

3.Daily deal discovery via voice in the kitchen

4.Hands-free price checks while cooking or working

5.Watchlist management from the couch

What data, how often, which direction

Data: Product records, current offers from tens of thousands of retailers and price history back to 2011, dense from 2019, from the ShopSavvy Data API. Prices are in US dollars.
How often: Every offer carries the time it was last checked. With the Data API you can schedule refreshes hourly, daily or weekly for retailers we can re-check through an official retailer API; other retailers update as ShopSavvy sees them.
Direction: ShopSavvy data flows into Amazon Alexa. Requests carry only what you ask about (identifiers, search terms or schedules) and your API key.

FAQ

Do I need an API key?

Yes. The Amazon Alexa integration calls the ShopSavvy Data API, which needs a Data API key. Create one at shopsavvy.com/data, then add it as the setup steps above show.

What data does it return?

ShopSavvy product records (title, brand, model, barcode, ASIN), current offers from tens of thousands of retailers with price, availability and condition, and price history back to 2011, dense from 2019. Products can be looked up by barcode, ASIN, URL or model number. Prices are in US dollars.

How fresh are the prices?

Every offer carries the time ShopSavvy last checked it, so you can see how current each price is. Through the Data API you can schedule refreshes hourly, daily or weekly for retailers we can re-check through an official retailer API; other retailers update as ShopSavvy sees them.

Is my API key stored securely?

The README has you supply it through the SHOPSAVVY_API_KEY environment variable or your own configuration, so it stays out of source code. The key is sent to the ShopSavvy API (api.shopsavvy.com) over HTTPS in the Authorization header. You can revoke a key and create a new one at shopsavvy.com/data/api-keys.

Is it open source?

Yes. The source is on GitHub at https://github.com/shopsavvy/alexa-shopsavvy-skill under the MIT license.

Powered by the ShopSavvy Data API

This integration connects to the ShopSavvy Data API: product data and current prices from tens of thousands of retailers, across 30M+ products, with price history back to 2011, dense from 2019. Look up products by barcode, ASIN, URL or keyword, compare prices, read history and schedule refreshes.

Get Started Read the Docs →