ShopSavvy for Dify

PythonComing soon

A Dify tool provider plugin with three tools for product search, price comparison, and price history. Add shopping data to any Dify workflow or agent.

View on GitHub Get Your API Key

Set up ShopSavvy for Dify

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
The ShopSavvy Dify integration was submitted to the Dify project (https://github.com/langgenius/dify-official-plugins/pull/2816). It is not part of Dify yet, so there is nothing to install there today. The ShopSavvy Data API and SDKs work now.
3
Add your API key
Enter your key where Dify asks for ShopSavvy credentials, as the README describes. Store it as a secret, not in code.
4
Make your first call
Look up a product by barcode, ASIN or URL and read its current offers. The langgenius/dify-official-plugins README has the full example: https://github.com/langgenius/dify-official-plugins/pull/2816#readme

Keys come with a Data API plan. See plans.

Features

Three tools: product search, current offers, price history

Full i18n support (English, Chinese, Portuguese)

Works in Dify workflows and agents

Credential validation on setup

Use Cases

1.Build visual shopping assistant workflows

2.Create no-code price comparison tools

3.Add product data to customer service agents

4.Build deal notification workflows

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 Dify. 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 Dify 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?

Store it as a secret in your own configuration, not in 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/langgenius/dify-official-plugins/pull/2816 under the Apache-2.0 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 →