# Criteo Docs: Retail Media API API Reference rm-2026-preview

## rm-2026-preview

### Accounts

- [/preview/retail-media/account-management/accounts/{accountId}/private-market-child-accounts](https://developers.criteo.com/retail-media/v2026-preview/reference/accounts/previewretail-mediaaccount-managementaccounts-private-market-child-accounts.md): Gets Private Market child accounts that are associated with the given account
- [/preview/retail-media/brands/search](https://developers.criteo.com/retail-media/v2026-preview/reference/accounts/previewretail-mediabrandssearch.md): Search for brands given a retailer ID and search term.

### Audience

- [/preview/retail-media/accounts/{account-id}/audience-segments](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segments.md): Updates the properties of all segments with a valid configuration, and returns the full segments. For those that cannot be updated, one or multiple errors are returned.
- [/preview/retail-media/accounts/{account-id}/audience-segments/{audience-segment-id}/contact-list](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segments-contact-list.md): Returns the statistics of a contact list segment.
- [/preview/retail-media/accounts/{account-id}/audience-segments/compute-sizes](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segmentscompute-sizes.md): Gets the size of all segments. An error is returned for those whose size calculation is not supported.
- [/preview/retail-media/accounts/{account-id}/audience-segments/create](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segmentscreate.md): Creates all segments with a valid configuration, and returns the full segments. For those that cannot be created, one or multiple errors are returned.
- [/preview/retail-media/accounts/{account-id}/audience-segments/delete](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segmentsdelete.md): Delete the segments associated to the given IDs.
- [/preview/retail-media/accounts/{account-id}/audience-segments/estimate-size](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segmentsestimate-size.md): Gets the size estimation of a non existent segment. An error is returned when size calculation is not supported.
- [/preview/retail-media/accounts/{account-id}/audience-segments/search](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audience-segmentssearch.md): Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied.
- [/preview/retail-media/accounts/{account-id}/audiences](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audiences.md): Updates the properties of all audiences with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned.
- [/preview/retail-media/accounts/{account-id}/audiences/compute-sizes](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audiencescompute-sizes.md): Gets the size of all audiences. An error is returned for those whose size calculation is not supported.
- [/preview/retail-media/accounts/{account-id}/audiences/create](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audiencescreate.md): Creates all audiences with a valid configuration, and returns their IDs. For those that cannot be created, one or multiple errors are returned.
- [/preview/retail-media/accounts/{account-id}/audiences/delete](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audiencesdelete.md): Deletes the audiences associated to the given IDs.
- [/preview/retail-media/accounts/{account-id}/audiences/estimate-size](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audiencesestimate-size.md): Gets the size estimation of a non existent audience. An error is returned when size calculation is not supported.
- [/preview/retail-media/accounts/{account-id}/audiences/search](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaccounts-audiencessearch.md): Returns a list of audiences that match the provided filters. If present, the filters are AND'ed together when applied.
- [/preview/retail-media/audience-segments/{audience-segment-id}/contact-list/add-remove](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaudience-segments-contact-listadd-remove.md): Add/remove identifiers to or from a retail-media contact list audience-segment, with external audience segment id.
- [/preview/retail-media/audience-segments/{audience-segment-id}/contact-list/clear](https://developers.criteo.com/retail-media/v2026-preview/reference/audience/previewretail-mediaaudience-segments-contact-listclear.md): Delete all identifiers from a retail-media contact list audience-segment, with external audience segment id.

### Balance

- [/preview/retail-media/accounts/{account-id}/balances/{balance-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/balance/previewretail-mediaaccounts-balances.md): Modify a balance for the given account id
- [/preview/retail-media/accounts/{accountId}/balances](https://developers.criteo.com/retail-media/v2026-preview/reference/balance/previewretail-mediaaccounts-balances-1.md): Gets page of balance objects for the given account id.
- [/preview/retail-media/balances/{balanceId}](https://developers.criteo.com/retail-media/v2026-preview/reference/balance/previewretail-mediabalances.md): Get a balance for the given balance id.
- [/preview/retail-media/balances/{balanceId}/history](https://developers.criteo.com/retail-media/v2026-preview/reference/balance/previewretail-mediabalances-history.md): Gets the balance's historical change data.

### Campaign

- [/preview/retail-media/accounts/{account-id}/creatives](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaaccounts-creatives.md): Create a creative for an account
- [/preview/retail-media/accounts/{account-id}/creatives/{creative-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaaccounts-creatives-1.md): Get the specified creative
- [/preview/retail-media/accounts/{account-id}/creatives/{creative-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaaccounts-creatives-2.md): Update a creative
- [/preview/retail-media/accounts/{account-id}/creatives/search](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaaccounts-creativessearch.md): Get account creatives
- [/preview/retail-media/accounts/{account-id}/line-items/cap-out-history](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaaccounts-line-itemscap-out-history.md): Get the cap out history for line items
- [/preview/retail-media/accounts/{accountId}/retailers/search](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaaccounts-retailerssearch.md): Searches for retailers associated with the specified account and returns budget model availability for each retailer
- [/preview/retail-media/auction-line-items/{lineItemId}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaauction-line-items.md): Gets a sponsored product line item by its id.
- [/preview/retail-media/auction-line-items/{lineItemId}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediaauction-line-items-1.md): Updates a Sponsored Products Line Item given a line item id and a request.
- [/preview/retail-media/balances/{balanceId}/campaigns/append](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediabalances-campaignsappend.md): Appends one or more campaigns to the specified balance
- [/preview/retail-media/balances/{balanceId}/campaigns/delete](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediabalances-campaignsdelete.md): Deletes one or more campaigns on the specified balance
- [/preview/retail-media/campaigns/{campaign-id}/preferred-line-items](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediacampaigns-preferred-line-items.md): Gets page of preferred line item objects for the given campaign id
- [/preview/retail-media/campaigns/{campaign-id}/preferred-line-items](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediacampaigns-preferred-line-items-1.md): Creates a new preferred line item with the specified settings
- [/preview/retail-media/campaigns/{campaignId}/auction-line-items](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediacampaigns-auction-line-items.md): Gets a page of sponsored product line items by campaign id.
- [/preview/retail-media/campaigns/{campaignId}/auction-line-items](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediacampaigns-auction-line-items-1.md): Creates new auction line item with the specified settings
- [/preview/retail-media/catalogs/{catalogId}/status](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediacatalogs-status.md): Check the status of a catalog request.
- [/preview/retail-media/line-items/{line-item-id}/product-buttons](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-product-buttons.md): Get LineItem Product Buttons
- [/preview/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-product-buttons-1.md): Get Specific Product Button
- [/preview/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-product-buttons-2.md): Update Specific Product Button
- [/preview/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-product-buttons-3.md): Delete Specific Product Button
- [/preview/retail-media/line-items/{line-item-id}/product-buttons/create](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-product-buttonscreate.md): Add Specific Product Buttons
- [/preview/retail-media/line-items/{line-item-id}/products](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-products.md): Retrieve a page of promoted products for a line item
- [/preview/retail-media/line-items/{line-item-id}/products/append](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-productsappend.md): Append a collection of promoted products to a line item
- [/preview/retail-media/line-items/{line-item-id}/products/delete](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-productsdelete.md): Remove a collection of promoted products from a line item
- [/preview/retail-media/line-items/{line-item-id}/products/pause](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-productspause.md): Pause a collection of promoted products associated with a line item
- [/preview/retail-media/line-items/{line-item-id}/products/unpause](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-medialine-items-productsunpause.md): Un-pause a collection of promoted products associated with a line item
- [/preview/retail-media/preferred-line-items/{line-item-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediapreferred-line-items.md): Gets the preferred line item for the given line item id
- [/preview/retail-media/preferred-line-items/{line-item-id}](https://developers.criteo.com/retail-media/v2026-preview/reference/campaign/previewretail-mediapreferred-line-items-1.md): Updates the preferred line item for the given line item id

### ThirdPartyAccounts

- [/preview/retail-media/accounts/{accountId}/grant-third-party-consent](https://developers.criteo.com/retail-media/v2026-preview/reference/thirdpartyaccounts/previewretail-mediaaccounts-grant-third-party-consent.md): Grant third-party consent to a business application on behalf of a Private Market demand account
- [/preview/retail-media/third-party-accounts/{accountId}/brands/{brandId}/remove](https://developers.criteo.com/retail-media/v2026-preview/reference/thirdpartyaccounts/previewretail-mediathird-party-accounts-brands-remove.md): Attempt to remove the provided brand from the account.
- [/preview/retail-media/third-party-accounts/{accountId}/brands/add](https://developers.criteo.com/retail-media/v2026-preview/reference/thirdpartyaccounts/previewretail-mediathird-party-accounts-brandsadd.md): add the provided brands to an account. This will not remove any existing brands.
- [/preview/retail-media/third-party-accounts/{accountId}/create-brand-account](https://developers.criteo.com/retail-media/v2026-preview/reference/thirdpartyaccounts/previewretail-mediathird-party-accounts-create-brand-account.md): Create a private market demand brand account under a given parent account.
- [/preview/retail-media/third-party-accounts/{accountId}/create-seller-account](https://developers.criteo.com/retail-media/v2026-preview/reference/thirdpartyaccounts/previewretail-mediathird-party-accounts-create-seller-account.md): Create a private market demand seller account under a given parent account.
- [/preview/retail-media/third-party-accounts/{accountId}/sellers](https://developers.criteo.com/retail-media/v2026-preview/reference/thirdpartyaccounts/previewretail-mediathird-party-accounts-sellers.md): Update the list of sellers mapped to the account. This will override any existing mappings.

### Catalog

- [/preview/retail-media/catalog/merchants/{merchantId}/store-inventory/delete](https://developers.criteo.com/retail-media/v2026-preview/reference/catalog/previewretail-mediacatalogmerchants-store-inventorydelete.md): Used to publish a batch of store inventories to delete. The batch is processed asynchronously.
- [/preview/retail-media/catalog/merchants/{merchantId}/store-inventory/upsert](https://developers.criteo.com/retail-media/v2026-preview/reference/catalog/previewretail-mediacatalogmerchants-store-inventoryupsert.md): Used to publish a batch of store inventories to upsert. The batch is processed asynchronously.
- [/preview/retail-media/catalog/products/batch](https://developers.criteo.com/retail-media/v2026-preview/reference/catalog/previewretail-mediacatalogproductsbatch.md): Used to publish a batch of operations to insert, update and deletes products.  The batch is processed asynchronously.The response provides an operationToken which can be used to track  the status of the report of the operation.
- [/preview/retail-media/catalog/products/batch/report/{operation-token}](https://developers.criteo.com/retail-media/v2026-preview/reference/catalog/previewretail-mediacatalogproductsbatchreport.md): Get the report of an asynchronous batch operation previously requested
- [/preview/retail-media/retailers/{retailer-id}/offers/update](https://developers.criteo.com/retail-media/v2026-preview/reference/catalog/previewretail-mediaretailers-offersupdate.md): Update one or more offers by replacing each offer's price and availability with the given values
- [/preview/retail-media/retailers/{retailer-id}/products/set-buy-box-winners](https://developers.criteo.com/retail-media/v2026-preview/reference/catalog/previewretail-mediaretailers-productsset-buy-box-winners.md): Update the buy box winner for one or more products

### OnSiteRecommendation

- [/preview/retail-media/chatbot-catalogs/{catalogid}/product-recommendations](https://developers.criteo.com/retail-media/v2026-preview/reference/onsiterecommendation/previewretail-mediachatbot-catalogs-product-recommendations.md): Ask a chatbot for a product recommendation

### Analytics

- [/preview/retail-media/insights/{insight-id}/output](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediainsights-output.md): Downloads the file output of a completed insight report. The report must have reached the `Success`
 status; otherwise an error is returned. Check readiness first with the insight status endpoint.
- [/preview/retail-media/insights/{insight-id}/status](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediainsights-status.md): Returns the current status of an asynchronously generated insight report. Poll this endpoint until the
 status is `Success`, then download the report from the insight output endpoint.
- [/preview/retail-media/insights/digital-shelf-intelligence](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediainsightsdigital-shelf-intelligence.md): Requests a Digital Shelf Intelligence insight report. This is an asynchronous, non-transactional operation:
 it does not return the analytic data. It enqueues an export job and returns the created insight
 report, whose id is then used to poll the insight status endpoint until the report is ready an…
- [/preview/retail-media/insights/share-of-voice](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediainsightsshare-of-voice.md): Requests a Share of Voice insight report. This is an asynchronous, non-transactional operation:
 it does not return the analytic data. It enqueues an export job and returns the created insight
 report, whose id is then used to poll the insight status endpoint until the report is ready and to
 downlo…
- [/preview/retail-media/reports/{reportId}/output](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareports-output.md): Returns the output of an async report
- [/preview/retail-media/reports/{reportId}/status](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareports-status.md): Returns the status of an async report
- [/preview/retail-media/reports/accounts](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportsaccounts.md): Returns an asynchronous Accounts Report
 <br />
 This endpoint is subject to specific rate limits.
- [/preview/retail-media/reports/campaigns](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportscampaigns.md): Return an asynchronous Campaigns Report
 <br />
 This endpoint is subject to specific rate limits.
- [/preview/retail-media/reports/fillrate](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportsfillrate.md): Returns an asynchronous Fill Rate Report
 <br />
 This endpoint is subject to specific rate limits.
- [/preview/retail-media/reports/line-items](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportsline-items.md): Returns an asynchronous Line Items Report
 <br />
 This endpoint is subject to specific rate limits.
- [/preview/retail-media/reports/offsite](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportsoffsite.md): Returns an asynchronous Offsite Report
 <br />
 This endpoint is subject to specific rate limits.
- [/preview/retail-media/reports/sync/attributed-transactions](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportssyncattributed-transactions.md): Returns a synchronous Attributed Transactions Report
- [/preview/retail-media/reports/sync/campaigns](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportssynccampaigns.md): Returns a synchronous Campaigns Report
- [/preview/retail-media/reports/sync/line-items](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportssyncline-items.md): Returns a synchronous Line Items Report
- [/preview/retail-media/reports/sync/real-time-performance](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportssyncreal-time-performance.md): Returns a synchronous Real Time Performance Report. Returns empty rows; metadata includes dataCompleteThrough (latest time from streaming table in the request timezone).
 <br />
 This endpoint is subject to specific rate limits.
- [/preview/retail-media/reports/unfilled-placements](https://developers.criteo.com/retail-media/v2026-preview/reference/analytics/previewretail-mediareportsunfilled-placements.md): Returns an asynchronous Unfilled Placements Report
 <br />
 This endpoint is subject to specific rate limits.

### Gateway

- [/preview/retail-media/me](https://developers.criteo.com/retail-media/v2026-preview/reference/gateway/previewretail-mediame.md): Get information about the currently logged application

## OpenAPI Specs

- [open-api-specifications](https://api.criteo.com/preview/retailmedia/open-api-specifications.json)