# All Data API endpoints and their credit costs

> Every ShopSavvy Data API endpoint on one page: method, path, what it returns and what it costs in credits, plus base URL, auth and identifier types.

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

---

| Method | Endpoint | Description | Cost |
|--------|----------|-------------|------|
| `GET` | `/products?ids={identifiers}` | Get product details | 1 credit/product found |
| `GET` | `/products?ids={identifiers}&format=csv` | Get product details in CSV | 1 credit/product found |
| `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 per product + 1 credit/day per request (0 when no offers found) |
| `GET` | `/products/reviews?id={identifier}` | Get TLDR review for a product | 1 credit (0 if no review) |
| `POST` | `/products/batch` | Batch product lookup (sync ≤20, async >20) | 1 credit/product found |
| `GET` | `/batch/{batchId}` | Poll an async batch job for results | 0 credits |
| `PUT` | `/products/scheduled?ids={identifiers}&schedule={interval}` | Enable scheduled monitoring | 1 credit/product |
| `PUT` | `/products/scheduled?ids={identifiers}&schedule={interval}` | Update monitoring schedule (same call as scheduling; updates in place) | 1 credit/product |
| `DELETE` | `/products/scheduled?ids={identifiers}` | Disable scheduled monitoring | 0 credits |
| `GET` | `/products/scheduled` | View all scheduled products | 0 credits |
| `GET` | `/deals?sort={sort}&limit={n}` | Browse current deals | 1 credit/10 deals |
| `GET` | `/usage` | Get usage statistics | 0 credits |
| `POST` | `/webhooks` | Register a webhook | 0 credits |
| `GET` | `/webhooks` | List your webhooks | 0 credits |
| `PUT` | `/webhooks/{id}` | Update a webhook (url, events, is_active) | 0 credits |
| `POST` | `/webhooks/{id}/test` | Send a test event to a webhook | 0 credits |
| `DELETE` | `/webhooks/{id}` | Delete a webhook | 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`)