Osmos partner program
One API. Every retailer running on Osmos.
For agencies and platforms. Manage your clients’ campaigns and pull their reporting across Osmos-powered retail media networks from your own platform. Brands connect their retailer seats to you once; you operate everything through a single API.
- Marketing API
- Campaigns, ad groups, creatives, targeting
- Reporting API
- Sync and async reports
- OAuth 2.0
- Brand-granted access, revocable any time
Who it is for
Built for the people who run media on behalf of brands
This program is for agencies and platforms. Access to a brand’s seat is always granted by that brand; partners are vetted and approved by Osmos, once, for every network. Advertisers and sellers managing their own account use their retailer’s advertiser portal instead.
Media agencies and holding groups
Run every client’s retail media from one place. Brands connect their Takealot, Pick n Pay or Bash seats to your platform; your planners and traders work through the Osmos API instead of a dozen retailer logins.
Platforms and technology partners
Commerce media platforms, bid-management tools and BI vendors that embed Osmos retailers into their own product. Campaign management, reporting and inventory forecasting through one integration.
How access works
Approved once by Osmos. Available on every network.
- 01
Apply
Sign in or create a partner account, then tell us who you are, which markets you operate in, which plan you need and how you will use each API.
- 02
Osmos reviews and approves
The Osmos partnerships team reviews fit and compliance. On approval you receive your credentials and are listed under Partners & APIs in every Osmos-powered retailer portal.
- 03
Brands connect their seats
From your platform a brand authorises each retailer seat with OAuth 2.0 — or pastes a one-time link code where the retailer embeds Osmos inside its own seller portal.
- 04
Operate through one API
Create campaigns, pull reports and sync audiences for every connected seat with the same Marketing API. The brand can revoke access at any time.
Example. A beauty brand works with an agency in South Africa. The agency is an approved Osmos partner. From the agency’s platform the brand connects its Takealot, Pick n Pay and Bash advertiser seats. The agency now manages all three through the Osmos API — without ever holding the brand’s retailer logins.
Plans
Standard to get started. Premium for scale.
Both plans are monthly subscriptions with usage-based API pricing. Full pricing is shown when you apply.
| Capability | Standard | Premium Scale |
|---|---|---|
| APIs available | Marketing API, Reporting API | All APIs — Marketing, Reporting, Inventory forecasting, MCP server |
| Reporting granularity | Daily | Hourly for the last 90 days, plus intraday |
| Data historyHow far back reports can go via API | Last 90 days | Last 365 days |
| Data export | Via API only | Files, Pub/Sub streams, BigQuery and scheduled file dumps |
| Rate limitsCampaign writes and report fetches | Base limits | Higher limits, pooled across connected seats |
| Multi-seat OAuthBrands connect many retailer seats to your app | Included | |
| Support | Email and a shared Slack channel | |
| Uptime commitment | 95% | 99.9% |
API reference
What you can call
Every endpoint is scoped by the seat the brand connected. Ad serving, events and catalog APIs stay retailer-side and are not exposed to partners.
Marketing API
Sponsored Product and Sponsored Display campaigns, ad groups, creatives, targeting, product sets, keyword and category bids, publish and pay.
Reporting API
Sync reports for small pulls, async jobs with status polling for large ones. Daily grain and 90 days of history on Standard; hourly, intraday and 365 days on Premium.
User access · OAuth 2.0
Authorise an application, exchange refresh and access tokens, list the entities a brand has authorised to your app.
Inventory forecasting API
Forecast available impressions by placement, page type and date range before you book or bid.
Data export
Beyond the API: Pub/Sub event streams, direct BigQuery access and scheduled file dumps into your warehouse.
MCP server
A hosted Model Context Protocol server exposing campaign, reporting and forecast tools so agents in Claude, ChatGPT or Gemini can operate connected seats.
Linking method A
OAuth 2.0 redirect
For retailers running the Osmos advertiser portal directly. The brand is redirected to Osmos, picks the retailer seat, approves scopes and is sent back to your app with an authorisation code. You exchange it for a refresh token.
GET https://auth.osmos.ai/oauth/authorize ?client_id=…&redirect_uri=…&scope=campaigns reporting&state=…
Linking method B
One-time link code
For retailers that embed the Osmos advertiser portal inside their own seller or brand portal (iframe). Redirects and refresh-token exchange are not possible there, so the brand generates a short-lived code in Settings › Developers & APIs and pastes it into your app.
POST https://auth.osmos.ai/oauth/token grant_type=link_code&code=OSM-7K4Q-9ZT2&client_id=…
Common questions
Questions partners ask
- Who decides which partners are allowed?
- Osmos does. Every partner is vetted and approved centrally, and an approved partner is available on every Osmos-powered network. Brands decide which partner, if any, manages their own seats, and can revoke a connection at any time.
- I am a brand or seller. Is this for me?
- Not this program. Advertisers and sellers managing their own account get API access through their retailer’s advertiser portal. This page is for the agencies and platforms that work on brands’ behalf.
- When do I get credentials?
- After your application is reviewed and approved. Your client ID and secret are then issued in the Partner Program.
- How do brands connect their seats?
- From your platform. Brands authorise each retailer seat with OAuth 2.0, or generate a one-time link code in their advertiser portal where the retailer embeds Osmos in its own seller site.
Ready to build?
Applications are reviewed by the Osmos partnerships team. Credentials are issued on approval.