> For the complete documentation index, see [llms.txt](https://developers.citrusad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.citrusad.com/integration/reference/catalog-products-reference.md).

# Catalog products reference

{% hint style="info" %}
Epsilon Retail Media's documentation is now centralized with our knowledgebase!

For up to date guides, please view [this page](https://help.citrusad.com/retail-media-interface/integration/references/catalog-products-reference) in the new Integration APIs space of our documentation.
{% endhint %}

The below outlines the properties possible in a standard sync request as outlined in [Syncing products via API](/integration/reference/syncing-products-via-api.md).

## Request items

| Property    | Description                                                                                                                                                                                                       | Required/optional                                                                                       | Example                                                                                                               |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `catalogId` | The catalog you are syncing to.                                                                                                                                                                                   | Required                                                                                                | `628dbe95-2ec9-4e07-881d-3e9f92ab2e0b`                                                                                |
| `filters`   | The filters associated with your product. This may be be category, location, and brand information.                                                                                                               | <p>Required<br>Max 750 characters</p>                                                                   | `"category:Health&Beauty","category:Grocery","Brand:Covergirl","Special_Flag:0"`                                      |
| `groups`    | Used for cross and upsell campaigns.                                                                                                                                                                              | <p>Deprecated for selection groups.<br>Still required for legacy product cross and upsell campaigns</p> | `[<br> "subClassName:Milk",<br> "xSellSubClassName:Coffee",<br> "xSellSubClassName:Tea"<br> "vendor:MilkBrand"<br> ]` |
| `gtin`      | The product code of the product in your system.                                                                                                                                                                   | <p>Required<br>Max 50 characters</p>                                                                    | `23556578965543`                                                                                                      |
| `inventory` | <p>The inventory of the product in your system. If set to 0, product ads will not serve.<br><br>If you cannot provide the number, do not send this field and Epsilon Retail Media will default inventory to 1</p> | <p>Required<br>32 bit unsigned integer recommended</p>                                                  | `1`                                                                                                                   |
| `price`     | The price of the product                                                                                                                                                                                          | <p>Optional<br>2 decimal points recommended</p>                                                         | `9.90`                                                                                                                |
| `profit`    | The profit made on the product                                                                                                                                                                                    | <p>Optional<br>2 decimal points recommended</p>                                                         |                                                                                                                       |
| `tags`      | Used to sync your product name and image that is surfaced in the Epsilon Retail Media portal. Follow the structure in the example.                                                                                | <p>Required<br>Max 750 characters</p>                                                                   | `"imageurl:<https://your.image.host.com/image.jpg","name:Covergirl> Clean 120 Creamy Natural Liquid Foundation30mL"`  |
| `sellerId`  | The unique Id of the seller. sellerIds are typically used when onboarding marketplace sellers.                                                                                                                    | <p>Optional<br>Max 50 characters</p>                                                                    | `73nns-32sxr-32ss` Custom per integration                                                                             |