> ## Documentation Index > Fetch the complete documentation index at: https://developers.criteo.com/llms.txt > Use this file to discover all available pages before exploring further. # Product Boost export const EndpointBadge = ({method = "GET", children}) => { const METHOD_STYLES = { GET: { bg: "mint-bg-[#2AB673]" }, POST: { bg: "mint-bg-[#3064E3]" }, PUT: { bg: "mint-bg-[#C28C30]" }, PATCH: { bg: "mint-bg-[#DA622B]" }, DELETE: { bg: "mint-bg-[#CB3A32]" }, API: { bg: "mint-bg-black" } }; const key = method.toUpperCase(); const styles = METHOD_STYLES[key] ?? METHOD_STYLES.API; return
{key} {children}
; }; ## Introduction Product Boost allows advertisers to amplify the visibility of specific product sets within an ad by applying a **boosting factor**. When configured, products belonging to the specified product set are weighted more heavily in the ad's delivery logic relative to unboosted products. Advertisers managing large catalogs can use Product Boost to surface priority products (e.g. seasonal items, high-margin SKUs, promoted lines) without creating separate ads. It provides a lightweight configuration layer on top of an existing ad, scoped to a product set. **Prerequisites:** * A valid Marketing Solutions ad ID (`ad-id`) — the ad must already exist * A valid product set ID (`product-set-id`) linked to a dataset associated with the ad * OAuth 2.0 Bearer token with scope `MarketingSolutions_Reco_Read` (read endpoints) or `MarketingSolutions_Reco_Manage` (POST and DELETE) **Key concepts:** * **Product set** — a curated subset of products from a catalog dataset, identified by `productSetId` * **Boosting factor** — a numeric multiplier applied to products in the set during ad serving; a value of `1` means no boost, values above `1` increase priority * **Dataset** — the catalog data source referenced by the ad; the dataset-level GET endpoint lets you inspect all boost configurations across a dataset regardless of which ad they belong to **Upsert behavior** The POST endpoint creates the boosting configuration if none exists for the given `(ad-id, product-set-id)` pair, or replaces it entirely if one already exists. There is no PATCH — send the full desired configuration each time. *** ## Endpoints Overview | Verb | Endpoint | Description | | :--------- | :---------------------------------------------------------------- | :------------------------------------------------------------- | | **GET** | `/marketing-solutions/ads/{ad-id}/product-boost` | List all product boost configurations for an ad | | **GET** | `/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}` | Get the product boost configuration for a specific product set | | **POST** | `/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}` | Create or replace a product boost configuration | | **DELETE** | `/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}` | Delete a product boost configuration | | **GET** | `/marketing-solutions/dataset/{dataset-id}/product-boost` | List all product boost configurations for a dataset | *** ## Attributes Resource type: `BoostedAdProductSet` | Attribute | Data Type | Description | | ------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `adId` | string | ID of the Marketing Solutions ad this configuration belongs to.

**Accepted values:** string of int64 / **Writeable?** N / **Nullable?** N | | `productSetId` | string | ID of the product set being boosted within the ad.

**Accepted values:** string of int64 / **Writeable?** N / **Nullable?** N | | `boostingFactor`\* | number (double) | Multiplier applied to products in the set during ad serving. A value of `1` means no boost.

**Accepted values:** positive float / **Writeable?** Y / **Nullable?** N | | `modificationDate` | string | Datetime of the last modification to this configuration.

**Accepted values:** datetime string / **Writeable?** N / **Nullable?** N | *\*Required at create/update operation* *** ## List all product boost configurations for an ad Returns all `BoostedAdProductSet` entries associated with the given ad. ```http theme={null} https://api.criteo.com/2027-01/marketing-solutions/ads/{ad-id}/product-boost ``` **Sample request** ```curl theme={null} curl -L -X GET 'https://api.criteo.com/2027-01/marketing-solutions/ads/1234567890/product-boost' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer ' ``` **Sample response** ```json theme={null} { "data": [ { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567890", "productSetId": "9876543210", "boostingFactor": 1.5, "modificationDate": "2026-07-21T10:30:00Z" } }, { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567890", "productSetId": "1122334455", "boostingFactor": 2.0, "modificationDate": "2026-07-15T08:00:00Z" } } ] } ``` *** ## Get a product boost configuration Returns the `BoostedAdProductSet` for the given `(ad-id, product-set-id)` pair. ```http theme={null} https://api.criteo.com/2027-01/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id} ``` **Sample request** ```curl theme={null} curl -L -X GET 'https://api.criteo.com/2027-01/marketing-solutions/ads/1234567890/product-boost/9876543210' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer ' ``` **Sample response** ```json theme={null} { "data": { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567890", "productSetId": "9876543210", "boostingFactor": 1.5, "modificationDate": "2026-07-21T10:30:00Z" } } } ``` *** ## Create or replace a product boost configuration Creates a new boosting configuration for the given `(ad-id, product-set-id)` pair. If a configuration already exists, it is fully replaced. Returns `201` on creation, `200` on update. ```http theme={null} https://api.criteo.com/2027-01/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id} ``` **Sample request** ```curl theme={null} curl -L -X POST 'https://api.criteo.com/2027-01/marketing-solutions/ads/1234567890/product-boost/9876543210' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "data": { "type": "BoostingConfigurationRequest", "attributes": { "boostingFactor": 1.5 } } }' ``` **Sample response** ```json theme={null} { "data": { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567890", "productSetId": "9876543210", "boostingFactor": 1.5, "modificationDate": "2026-08-01T14:22:00Z" } } } ``` *** ## Delete a product boost configuration Removes the boosting configuration for the given `(ad-id, product-set-id)` pair. Products in the set will no longer receive any boost. The ad itself and the product set remain unaffected. Returns the deleted resource in the response body. ```http theme={null} https://api.criteo.com/2027-01/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id} ``` **Sample request** ```curl theme={null} curl -L -X DELETE 'https://api.criteo.com/2027-01/marketing-solutions/ads/1234567890/product-boost/9876543210' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer ' ``` **Sample response** ```json theme={null} { "data": { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567890", "productSetId": "9876543210", "boostingFactor": 1.5, "modificationDate": "2026-08-01T14:22:00Z" } } } ``` *** ## List product boost configurations for a dataset Returns all `BoostedAdProductSet` configurations associated with the given dataset, across all ads. Optionally filter by `client-type`. ```http theme={null} https://api.criteo.com/2027-01/marketing-solutions/dataset/{dataset-id}/product-boost ``` **Query parameters** | Parameter | Type | Required | Description | | ------------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------- | | `client-type` | string | No | Filter results by client type. Accepted values: `Unknown`, `CGrowth`, `CMax`. Returns all configurations if omitted. | **Sample request** ```curl theme={null} curl -L -X GET 'https://api.criteo.com/2027-01/marketing-solutions/dataset/5544332211/product-boost?client-type=CMax' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer ' ``` **Sample response** ```json theme={null} { "data": [ { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567890", "productSetId": "9876543210", "boostingFactor": 1.5, "modificationDate": "2026-07-21T10:30:00Z" } }, { "type": "BoostedAdProductSet", "attributes": { "adId": "1234567891", "productSetId": "9876543211", "boostingFactor": 3.0, "modificationDate": "2026-07-28T09:15:00Z" } } ] } ``` *** ## Responses | Response | Title | Detail | Troubleshooting | | -------- | ------------ | -------------------------------------------- | ----------------------------------------------------------------------------------- | | 🟢 `200` | OK | | Request executed successfully; response body contains the resource | | 🟢 `201` | Created | | POST executed successfully — new boosting configuration created | | 🔴 `400` | Bad Request | `boostingFactor` must be greater than 0 | Review the value of `boostingFactor` in the request body | | 🔴 `401` | Unauthorized | Missing or invalid Bearer token | Verify that the Authorization header contains a valid, non-expired access token | | 🔴 `403` | Forbidden | Caller does not have access to this resource | Check that the token scope is `MarketingSolutions_Reco_Manage` for write operations | | 🔴 `404` | Not Found | Ad or product set ID does not exist | Verify that `ad-id` and `product-set-id` exist and are accessible to the caller |