Dev Hub
Sign in

Osmos developer hub

Build retail media
on Osmos.

Guides, SDKs and API references for sponsored product, display, offsite and in-store ads — everything you need to integrate.

search-page.jsSponsored Product Ads
// Fetch sponsored product ads for a search page
const apiUrl = 'https://<YOUR_SUB_DOMAIN>.o-s.io/sda';

// params: { pageType, keywords, uniqueShopperId, … }
async function fetchProducts(params) {
  const queryParams = buildQueryParameters(params);
  const adResponse = await fetch(`${apiUrl}?${queryParams}`, {
    method: 'GET',
    headers: { accept: 'application/json' },
  });
  const adResponseData = await adResponse.json();
  return adResponseData.products;
}
Full recipe: Render Sponsored Product Ads on a search page