Overview
The Aampe Content API provides programmatic access to retrieve personalized content for your users across different surfaces. This API powers real-time content decisioning based on your configured agents and optimization strategies.Base URL
All API requests should be made to:https://content.api.aampe.com
Getting Started
- Contact your Aampe representative or access your dashboard to generate an API key.
- Test the API with our health endpoint to verify your connection.
- Use the surface content endpoint to get personalized content for your users.
Core Concepts
Surfaces
Surfaces represent locations in your application where Aampe can deliver personalized content. Each surface has a unique UUID and associated configuration.Assignments
When you request content for a surface, Aampe returns an assignment - the specific content variant selected for that user at that moment, along with any configured alternates.Contact IDs
Your user identifiers that Aampe uses to personalize content delivery and track performance.Response Formats
All API responses return JSON. Successful requests return appropriate HTTP status codes (200 for successful GET requests) along with the requested data.Error Handling
The API uses standard HTTP status codes:200- Success400- Bad Request401- Unauthorized (invalid API key)422- Validation Error429- Rate Limited500- Server Error