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;
}Browse
Docs
All- Get startedSet up access to Osmos and find your way around the platform.
- Ad formatsOnsite, offsite and in-store ads, and bringing your own traffic.
- IntegrationsConnect events, audiences, ad servers, CDNs, tracking and payments.
- SDK Integration guidesIntegrate Osmos ads in mobile apps, websites and in-store screens.
- Platform & policiesAttribution, data privacy and security, troubleshooting and legal pages.
- RecipesStep-by-step code walkthroughs for common integrations.
API
All- Ad servingFetch and render sponsored product, display and in-store ads.
- Campaign managementCreate and manage campaigns, creatives and forecasts.
- Data & eventsSend events, sync catalogs and audiences.
- Reporting & billingPull performance reports and manage wallets and billing.
- Access & adminAuthenticate with OAuth and administer retailer settings.
SDKs