Skip to content

EngageHQ APIPublic Content Delivery API

High-performance, CDN-optimized API for integrating content, circulars, and offers into your web applications

Quick Start

Make your first API request in seconds:

javascript
const response = await fetch('https://cdn.engagehq.retailsuccessplatform.com/api/v1/public/content', {
  headers: {
    'Authorization': 'Bearer YOUR_JWT_TOKEN',
  },
});

const { data } = await response.json();
console.log(data); // Array of published content items

Base URLs

EnvironmentURLPurpose
Production (CDN)https://cdn.engagehq.retailsuccessplatform.com/api/v1/publicPublic content delivery (recommended)
Production (direct)https://api.engagehq.retailsuccessplatform.com/api/v1/publicAdmin/management API
Staginghttps://api-staging.engagehq.retailsuccessplatform.com/api/v1/publicStaging environment

Use the CDN endpoint

For public content delivery, always use cdn.engagehq.retailsuccessplatform.com. Content is cached at edge locations worldwide and automatically invalidated when published, giving you the best performance and guaranteed freshness.

Available Endpoints

EndpointDescription
GET /contentList published content items
GET /content/{slug}Get a specific content item
GET /circularsList available circulars
GET /circulars/{id}Get circular with layout data
GET /offersList active offers
GET /offers/{id}Get offer details

Response Format

All endpoints return a consistent JSON structure:

json
{
  "success": true,
  "message": "Content retrieved",
  "data": [ /* array or object */ ],
  "meta": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 20,
    "total": 94
  }
}

Need Help?


Changelog
DateChange
2026-03-24Added custom types and platform elements features.
2026-02-23Updated for CloudFront CDN delivery.
2026-01-28Expanded documentation.
2026-01-15Initial publication.

EngageHQ Public Content Delivery API