Skip to main content
The Uplift Ads API is the ad-server layer of the Platform 195 stack. Where the Uplift Hub API manages your campaign data model — accounts, campaigns, and line items — the Uplift Ads API handles delivery: requesting ad decisions for your placements in real time.
Looking for the campaign management API? See Getting started with the Uplift Hub API.

​
Which API do I need?

TaskAPI
Create or update accounts, campaigns, line itemsUplift Hub API
Request a Native ad decisionUplift Ads API — POST /native-ad
Request a Sponsored ad decisionUplift Ads API — POST /sponsored-ad
Request a Recommender ad decisionUplift Ads API — POST /recommender-ad
Request a Display ad decisionUplift Ads API — POST /display-ad

​
Getting access

Access to the Uplift Ads API is managed separately from the Uplift Hub API. Contact your Platform 195 account manager to request credentials — they will provide you with an API key and your Site ID.
No account manager yet? Email support@uplifthub.io.

​
Authentication

Every request requires two headers:
HeaderDescription
x-api-keyYour Uplift Ads API key
x-site-idYour numeric Site ID
x-api-key: YOUR_API_KEY
x-site-id: 12345
Requests without both headers will be rejected.

​
Base URL

All endpoints are relative to: https://api.upliftads.io/v3

​
Ad types

EndpointFormatUse when
POST /native-adNativeRendering ads that match surrounding content — headline, image, and CTA
POST /sponsored-adSponsoredSurfacing sponsored products within search or browse results
POST /recommender-adRecommenderShowing AI-ranked product recommendations in a carousel or grid
POST /display-adDisplayServing banner or rich-media creatives at a fixed size

​
Next steps

Browse the Uplift Ads API Reference tab for the full interactive endpoint documentation, including request and response schemas. For implementation guides covering each ad format in detail, see the Uplift Ads section.