# Get a product's current price at every retailer

> GET /v1/products/offers returns every current offer for a product: retailer, price, availability, condition, marketplace seller and when it was last seen.

*Source: https://shopsavvy.com/data/documentation/offers-all-retailers* · Part of the [ShopSavvy Data API documentation](https://shopsavvy.com/data/documentation.md)

---

**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](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"
        }
      ]
    }
]
```