Get a product's current price at every retailer

Cost: 3 credits per product that has offers. Products with no offers, and identifiers that match nothing, cost nothing.

An offer represents a product being sold by a specific retailer or seller for a specific price, condition, etc.

Currency: the offer endpoints currently return USD-denominated offers only, and there is no parameter to request other currencies. ShopSavvy does mine offers in other currencies, so for a product whose only offers are non-USD (a UK-only retailer, for example) these endpoints return an empty offers array rather than an error — an empty array means "no USD offers on file", which is not the same as "no offers exist". If you need non-USD coverage, contact us at hello@greatwork.company.

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"`.
`condition_grade`	A finer grade alongside `condition` when the retailer states one, such as `"open-box"`, `"refurbished-excellent"`, or `"used-like-new"`. `null` when the retailer did not grade it.
`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.
`is_marketplace`	`true` when the offer is sold by a third-party marketplace seller (named in `seller`), `false` when it is sold by the retailer itself, `null` when the source did not say. Use it to build "sold by the retailer only" views.
`URL`	The URL for the offer.
`timestamp`	An ISO 8601 formatted date and time representing when the offer was last seen by ShopSavvy.

Example Response

[
    {
      "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"
        }
      ]
    }
]