---
title: "The structure of the data object in Incremental Feed API requests"
slug: "the-structure-of-the-data-object-in-incremental-feed-api-requests"
abstract: "Describes the structure of the data object in POST requests to the Sitecore Discover Incremental Feed API."
---
# The structure of the data object in Incremental Feed API requests

In the Sitecore Discover Incremental Feed API, the `data` object (in JSON format) contains updates to product information. This topic describes the structure of the `data` object, including its nested objects and properties (key-value pairs).

The following shows an example of the `data` object in JSON format:

```csharp
{
   "data": {
    "products": [
      {
        "sku": "<sku number>",
        "store": {
           "id": "<store id>",
           "group": "<store group identifier>"
        },
        "locale_country": "<2 letter country code, eg: us>",
        "locale_language": "<2 letter language code, eg: en>",
        "restriction": {
           "isAvailable": true|false
        },
        "attributes": {
           "<attribute-name-to-update>": "<value>",
           "<attribute-name-to-update>": "<value>",
           "..."
        }
      },
      { ... }
    ]
  }
}
```

The `data` object supports the following key:

| Key | Type | Description |
| --- | --- | --- |
| `products` | Array of objects | Required.<br><br>Array of products to update. |

> [!important]
> We recommend to include a maximum of 10 products in each API request.

<details>
<summary><h2>The products object</h2></summary>

The `products` object is an array of nested unkeyed product objects, each representing a product to update. Each nested product object contains key values that identify the product to update, and a required `attribute` object that specifies the product attributes to update.

The `products` object supports the following key:

| Key | Type | Description |
| --- | --- | --- |
| sku | string | Required.The unique value identifying the stock keeping unit (SKU) to update.NoteTo update an attribute that is not specific to a product SKU, you can specify any sku value that belongs to the product. |
| locale_country | string | Optional.The country code of the localized attribute to update. |
| locale_language | string | Optional.The language code of the localized attribute to update. |
| store | object | Optional.If your Discover implementation is set up for B2B or multiple stores support, you can include this object to update an attribute for a specific customer or group of customers, or for a specific store or group of stores. |
| restriction | object | Optional.Use this object if your Discover implementation is set up to support B2B or multiple stores, and you use whitelisting or blacklisting attributes to manage product availability per customer or group of customers, or per store or group of stores. |
| attributes | object | Required.The product attributes (in key-value pair) to update. |

### Updates to localized attributes

If your domain is set up for multi locale support, you can include parameters to update a localized attribute for a given country or language.

You can chose to specify only the language. If you do so, then all countries configured to use that language are updated with the given values.

> [!important]
> When you specify locale key values, you must ensure that the codes and convention you use to represent language and country are consistent with those you use in the [product feed](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/keep-product-data-up-to-date-using-the-incremental-feed-api/product-data-feed-specifications.html#UUID-7f28133c-26da-efa9-4685-6be206aae57a_section-idm4566335683782433037443379174 "Locale attributes").

The following table lists supported keys for locale:

| Key | Value type | Description |
| --- | --- | --- |
| `locale_language` | string | Optional.<br><br>A code representing a language.<br><br>If a value is specified, all product attributes configured to use that language are updated. |
| `locale_country` | string | Optional.<br><br>A code representing the country.<br><br>If a value is specified, product attributes that specify this locale (language and country) are updated. |

### The store object

The `store` object contains keys used to update product data for specific stores or groups of stores, or customers or groups of customers in the Discover implementation set up for multistore or for B2B support.

| Key | Type | Description |
| --- | --- | --- |
| id | string | Optional.A unique store ID (multistore support) or a unique customer ID (B2B).NoteThe specified id must exist in Discover. It must be provisioned in Discover using the full product feed. For example, you might have included this ID as part of the full data feed if you are using availability restriction or overrides. |
| group | string | Optional.If your stores are organized in a two-level hierarchy (for example, as zones or regions and stores), or if you have a B2B site with customers organized in a two-level hierarchy, you pass the top level organization identifier as a group key value.NoteThe specified group must exist in Discover. It must be provisioned in Discover using the full product feed. For example, you might have included this ID as part of the full data feed if you are using availability restriction or overrides. |

### The restriction object

Use the `restriction` object to update product availability for each store or customer, if your Discover implementation is set up to support B2B or multiple stores, and you use [B2B availability and restriction](https://doc.sitecore.com/discover/en/developers/discover-developer-guide/keep-product-data-up-to-date-using-the-incremental-feed-api/product-data-feed-specifications.html#UUID-7f28133c-26da-efa9-4685-6be206aae57a_section-idm4566334898657633037442743281 "Product availability and restriction attributes in multistore and B2B scenarios") (whitelisting and blacklisting) attributes.

> [!note]
> If you do not use availability restriction in your implementation to manage product availability for each customer or store, but instead you use `stock_quantity` attribute for this purpose, then you can use the `[attributes](the-structure-of-the-data-object-in-incremental-feed-api-requests.html#UUID-716f1ff8-c5da-f8d2-9505-e9631fafe448_section-idm4652146089524832880039362805 "The attributes object")` object to pass the updated `stock_quantity` value.

The following table lists the key of the `restriction` object:

|     |     |     |
| --- | --- | --- |
| **Key** | **Type** | **Description** |
| `isAvailable` | Boolean | Required if the `restriction` object is included.<br><br>When set to `true`, the product/SKU is available for the given B2B customer or store.<br><br>When set to `false`, the product/SKU is not available for the given customer or store.<br><br>Example:<br><br>```csharp<br>"restriction": {<br>  "isAvailable": true\|false<br>  }<br>``` |

### The attributes object

You use the `attributes` to update various product attributes.

The following table lists `attributes` keys:

| Key | Type | Description |
| --- | --- | --- |
| <product attribute> | Various | Optional.One of more product attribute key-value pairs to update, for example, to update price and the stock quantity of a product, you pass the following key-value pairs:"price": 23.45 "stock_quantity": 30NoteYou can only pass attributes that are part of your data feed.API requests that contain invalid attributes are rejected. |

</details>