> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blazemonitors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Monitored product management system

### Purpose

The Items API provides comprehensive functionality for managing monitored products. This unified system replaces the previous separate "lists" and "mutes" endpoints, offering enhanced features including:

* Add/remove products from monitoring
* Force-add products (bypassing certain validations)
* Mute/unmute products to control notifications
* Manage affiliate links for tracked products
* Configure price and stock alerts with custom thresholds
* View hyped (popular) products

### Query Parameters

All endpoints require the `site` parameter, which specifies the monitor name. A list of available monitors can be found using the [Monitor Sites endpoint](/monitor/sites).

### Request Body Format

Most endpoints that modify items use the following request format:

```json theme={null}
{
  "items": [
    {
      "itemId": "B09DFHJTF5",
      "config": {
        "monitorPrice": true,
        "priceAlertMaxPrice": 450.00,
        "stockAlertMaxPrice": 500.00,
        "mutedVariants": {}
      }
    }
  ]
}
```

### Response Body

The response from the API contains two main parts:

* `site`: An object that contains information about the site being queried.
* `results`: An object with product IDs as keys and result objects as values.

### Site Object

The `site` object contains detailed information about the monitoring site, including supported features and configuration options.

### Results Object

Each result in the `results` object has the following structure:

| Field   | Type      | Description                              |
| ------- | --------- | ---------------------------------------- |
| error   | `Boolean` | Indicates if an error occurred           |
| status  | `String`  | Detailed status indicating error/success |
| product | `Object`  | Product object with detailed information |
| config  | `Object`  | Item configuration settings              |

### Product Object

The `product` object contains comprehensive product information including SKU, name, price, images, and monitoring metadata.

### Item Configuration

Item configurations allow fine-grained control over monitoring behavior:

* **Price Monitoring**: Enable/disable price change alerts
* **Stock Alerts**: Set maximum price thresholds for stock notifications
* **Price Alerts**: Set maximum price thresholds for price drop notifications
* **Muted Variants**: Selectively mute specific product variants