All Data API endpoints and their credit costs
Last updated · Changelog · OpenAPI spec · Markdown
| 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)
Was this page helpful?