Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
How to authenticate and make ad-decision requests using the Uplift Ads API.
| Task | API |
|---|---|
| Create or update accounts, campaigns, line items | Uplift Hub API |
| Request a Native ad decision | Uplift Ads API — POST /native-ad |
| Request a Sponsored ad decision | Uplift Ads API — POST /sponsored-ad |
| Request a Recommender ad decision | Uplift Ads API — POST /recommender-ad |
| Request a Display ad decision | Uplift Ads API — POST /display-ad |
| Header | Description |
|---|---|
x-api-key | Your Uplift Ads API key |
x-site-id | Your numeric Site ID |
x-api-key: YOUR_API_KEY
x-site-id: 12345
| Endpoint | Format | Use when |
|---|---|---|
POST /native-ad | Native | Rendering ads that match surrounding content — headline, image, and CTA |
POST /sponsored-ad | Sponsored | Surfacing sponsored products within search or browse results |
POST /recommender-ad | Recommender | Showing AI-ranked product recommendations in a carousel or grid |
POST /display-ad | Display | Serving banner or rich-media creatives at a fixed size |
Was this page helpful?