# Criteo Docs: Retail Media API API Reference

## API Reference

- [Retail Media API / API Reference / rm-2026.07 (115 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2026-07.md): Documentation for Retail Media API / API Reference / rm-2026.07.
- [Retail Media API / API Reference / rm-2027.01-rc (114 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2027-01-rc.md): Documentation for Retail Media API / API Reference / rm-2027.01-rc.
- [Retail Media API / API Reference / rm-2026.01 (108 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2026-01.md): Documentation for Retail Media API / API Reference / rm-2026.01.
- [Retail Media API / API Reference / rm-2026-preview (78 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2026-preview.md): Documentation for Retail Media API / API Reference / rm-2026-preview.
- [Retail Media API / API Reference / rm-2025.10 (105 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2025-10.md): Documentation for Retail Media API / API Reference / rm-2025.10.
- [Retail Media API / API Reference / rm-2025.07 (100 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2025-07.md): Documentation for Retail Media API / API Reference / rm-2025.07.
- [Retail Media API / API Reference / rm-2025.04 (92 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2025-04.md): Documentation for Retail Media API / API Reference / rm-2025.04.
- [Retail Media API / API Reference / rm-2025.01 (88 pages)](https://developers.criteo.com/_llms/retail-media-api/api-reference/rm-2025-01.md): Documentation for Retail Media API / API Reference / rm-2025.01.

### rm-experimental

#### Audience

- [/experimental/retail-media/accounts/{account-id}/audience-segments/compute-sizes](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-mediaaccounts-audience-segmentscompute-sizes.md): Gets the size of all segments. An error is returned for those whose size calculation is not supported.
- [/experimental/retail-media/accounts/{account-id}/audience-segments/estimate-size](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-mediaaccounts-audience-segmentsestimate-size.md): Gets the size estimation of a non existent segment. An error is returned when size calculation is not supported.
- [/experimental/retail-media/accounts/{account-id}/audiences](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-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.
- [/experimental/retail-media/accounts/{account-id}/audiences/compute-sizes](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-mediaaccounts-audiencescompute-sizes.md): Gets the size of all audiences. An error is returned for those whose size calculation is not supported.
- [/experimental/retail-media/accounts/{account-id}/audiences/create](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-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.
- [/experimental/retail-media/accounts/{account-id}/audiences/delete](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-mediaaccounts-audiencesdelete.md): Deletes the audiences associated to the given IDs.
- [/experimental/retail-media/accounts/{account-id}/audiences/estimate-size](https://developers.criteo.com/retail-media/experimental/reference/audience/experimentalretail-mediaaccounts-audiencesestimate-size.md): Gets the size estimation of a non existent audience. An error is returned when size calculation is not supported.

#### Campaign

- [/experimental/retail-media/accounts/{account-id}/campaigns](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaaccounts-campaigns.md): Creates a campaign under the specified account.
- [/experimental/retail-media/accounts/{account-id}/creatives](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaaccounts-creatives.md): Create a creative for an account
- [/experimental/retail-media/accounts/{account-id}/creatives/{creative-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaaccounts-creatives-1.md): Get the specified creative
- [/experimental/retail-media/accounts/{account-id}/creatives/{creative-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaaccounts-creatives-2.md): Update a creative
- [/experimental/retail-media/accounts/{account-id}/creatives/search](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaaccounts-creativessearch.md): Get account creatives
- [/experimental/retail-media/accounts/{account-id}/line-items/cap-out-history](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaaccounts-line-itemscap-out-history.md): Get the cap out history for line items
- [/experimental/retail-media/auction-line-items/{lineItemId}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediaauction-line-items.md): Updates a Sponsored Products Line Item given a line item id and a request.
- [/experimental/retail-media/campaigns/{campaign-id}/preferred-line-items](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediacampaigns-preferred-line-items.md): Creates a new preferred line item with the specified settings
- [/experimental/retail-media/campaigns/{campaignId}/auction-line-items](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediacampaigns-auction-line-items.md): Creates new auction line item with the specified settings
- [/experimental/retail-media/catalogs/{catalogId}/status](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediacatalogs-status.md): Check the status of a catalog request.
- [/experimental/retail-media/line-items](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items.md): Create a new line item.
- [/experimental/retail-media/line-items/{line-item-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-1.md): Update an existing line item.
- [/experimental/retail-media/line-items/{line-item-id}/bidding-strategy](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-bidding-strategy.md): Returns the current bidding configuration for a Display auction line item, including the active
 bidding strategy and any preserved Standard and Adaptive strategy settings. Other line item types are
 not currently supported by this endpoint.
- [/experimental/retail-media/line-items/{line-item-id}/creatives](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-creatives.md): Retrieve the creatives and product collections associated with a line item.
- [/experimental/retail-media/line-items/{line-item-id}/creatives/delete](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-creativesdelete.md): Delete creatives and their product collections from a line item.
- [/experimental/retail-media/line-items/{line-item-id}/creatives/upsert](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-creativesupsert.md): Resolves each supplied stable creative identifier to its latest revision and
 associates those revisions with the line item's proposal.
- [/experimental/retail-media/line-items/{line-item-id}/product-buttons](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-product-buttons.md): Get LineItem Product Buttons
- [/experimental/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-product-buttons-1.md): Get Specific Product Button
- [/experimental/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-product-buttons-2.md): Update Specific Product Button
- [/experimental/retail-media/line-items/{line-item-id}/product-buttons/{product-button-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-product-buttons-3.md): Delete Specific Product Button
- [/experimental/retail-media/line-items/{line-item-id}/product-buttons/create](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-product-buttonscreate.md): Add Specific Product Buttons
- [/experimental/retail-media/line-items/{line-item-id}/products/add](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-productsadd.md): Add products to a line item.
- [/experimental/retail-media/line-items/{line-item-id}/products/delete](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-productsdelete.md): Delete products from a line item.
- [/experimental/retail-media/line-items/{line-item-id}/targets](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-targets.md): Returns a list of targets for a given line item id
- [/experimental/retail-media/line-items/{line-item-id}/targets/create](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-items-targetscreate.md): Creates a given target
- [/experimental/retail-media/line-items/demand-search](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-itemsdemand-search.md): Search line items accessible from demand accounts.
- [/experimental/retail-media/line-items/supply-search](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-medialine-itemssupply-search.md): Search line items accessible from a supply account and its retailers.
- [/experimental/retail-media/preferred-line-items/{line-item-id}](https://developers.criteo.com/retail-media/experimental/reference/campaign/experimentalretail-mediapreferred-line-items.md): Updates the preferred line item for the given line item id

#### Balance

- [/experimental/retail-media/accounts/{accountId}/balances](https://developers.criteo.com/retail-media/experimental/reference/balance/experimentalretail-mediaaccounts-balances.md): Gets page of balance objects for the given account id.

#### ThirdPartyAccounts

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

#### Accounts

- [/experimental/retail-media/brands/search](https://developers.criteo.com/retail-media/experimental/reference/accounts/experimentalretail-mediabrandssearch.md): Search for brands given a retailer ID and search term.

#### Catalog

- [/experimental/retail-media/catalog/ingestion/{ingestion-id}/reports/summary](https://developers.criteo.com/retail-media/experimental/reference/catalog/experimentalretail-mediacatalogingestion-reportssummary.md): Get the summary report of a catalog ingestion: what triggered it, how long it ran, how many offers it held, what it changed and how clean the data was.
- [/experimental/retail-media/catalog/merchants/{merchant-id}/ingestion/reports](https://developers.criteo.com/retail-media/experimental/reference/catalog/experimentalretail-mediacatalogmerchants-ingestionreports.md): List the catalog ingestions of a merchant, most recent first, with their type, status and timing.
- [/experimental/retail-media/catalog/products/batch](https://developers.criteo.com/retail-media/experimental/reference/catalog/experimentalretail-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.
- [/experimental/retail-media/catalog/products/batch/report/{operation-token}](https://developers.criteo.com/retail-media/experimental/reference/catalog/experimentalretail-mediacatalogproductsbatchreport.md): Get the report of an asynchronous batch operation previously requested
- [/experimental/retail-media/retailers/{retailer-id}/offers/update](https://developers.criteo.com/retail-media/experimental/reference/catalog/experimentalretail-mediaretailers-offersupdate.md): Update one or more offers by replacing each offer's price and availability with the given values
- [/experimental/retail-media/retailers/{retailer-id}/products/set-buy-box-winners](https://developers.criteo.com/retail-media/experimental/reference/catalog/experimentalretail-mediaretailers-productsset-buy-box-winners.md): Update the buy box winner for one or more products

#### OnSiteRecommendation

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

#### Analytics

- [/experimental/retail-media/insights/{insight-id}/output](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-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.
- [/experimental/retail-media/insights/{insight-id}/status](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-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.
- [/experimental/retail-media/insights/digital-shelf-intelligence](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-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…
- [/experimental/retail-media/insights/share-of-voice](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-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…
- [/experimental/retail-media/reports/accounts](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-mediareportsaccounts.md): Returns an asynchronous Accounts Report
 <br />
 This endpoint is subject to specific rate limits.
- [/experimental/retail-media/reports/campaigns](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-mediareportscampaigns.md): Return an asynchronous Campaigns Report
 <br />
 This endpoint is subject to specific rate limits.
- [/experimental/retail-media/reports/line-items](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-mediareportsline-items.md): Returns an asynchronous Line Items Report
 <br />
 This endpoint is subject to specific rate limits.
- [/experimental/retail-media/reports/offsite](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-mediareportsoffsite.md): Returns an asynchronous Offsite Report
 <br />
 This endpoint is subject to specific rate limits.
- [/experimental/retail-media/reports/sync/real-time-performance](https://developers.criteo.com/retail-media/experimental/reference/analytics/experimentalretail-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.

#### Gateway

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

## OpenAPI Specs

- [open-api-specifications](https://api.criteo.com/2026-07/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/2027-01/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/experimental/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/2026-01/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/preview/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/2025-10/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/2025-07/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/2025-04/retailmedia/open-api-specifications.json)
- [open-api-specifications](https://api.criteo.com/2025-01/retailmedia/open-api-specifications.json)