Getting Started

Overview

Momentize.ai detects high-value moments in AI conversations and serves relevant sponsored content blocks (SCBs). Monetize the Moments in your AI apps. The API is designed to be FTC-compliant, keeping sponsored content structurally separate from AI responses.

Self-Hosted Setup

Get the Momentize.ai backend running locally in under 5 minutes using Docker.

Prerequisites

• • Docker and Docker Compose installed
• • Git for cloning the repository
• • 4GB+ RAM available

Installation

# Clone the repository
git clone https://github.com/momentizeai/api
cd momentize-backend

# Start the services
docker compose up -d

# Check health
curl http://localhost:8000/health

Test Your Installation

curl -X POST http://localhost:8000/v1/analyze \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": [
      {
        "role": "user",
        "content": "I need help choosing between iPhone and Samsung"
      }
    ],
    "session_id": "test-session"
  }'

Basic Integration

Integrate Momentize.ai into your application with a few simple API calls.

JavaScript/TypeScript

// Install the SDK
npm install momentize-sdk

// Initialize
import { Momentize } from 'momentize-sdk';

const momentize = new Momentize({
  apiKey: 'your-api-key',
  baseUrl: 'https://api.momentize.ai'
});

// Analyze conversation
const result = await momentize.analyze({
  conversation: messages,
  sessionId: 'unique-session-id'
});

// Display sponsored content
result.sponsored_content.forEach(ad => {
  displaySponsoredContent(ad);
});

// Track events
await momentize.trackEvent({
  eventType: 'impression',
  sessionId: 'unique-session-id',
  impressionId: ad.impression_id
});

Understanding Moments

Momentize.ai detects 7 different types of high-value conversation moments:

Best Practices

FTC Compliance

• • Always display the disclosure field prominently
• • Keep sponsored content visually separate from AI responses
• • Use clear labels like "Sponsored" or "Advertisement"
• • Don't modify the disclosure text provided by the API

Performance Optimization

• • Implement request caching for repeated conversations
• • Use consistent session IDs for proper frequency capping
• • Track all impression events for accurate analytics
• • Monitor your rate limits and implement retries

User Experience

• • Only show 1-2 sponsored content blocks per conversation
• • Ensure sponsored content is relevant to detected moments
• • Provide clear visual distinction from organic content
• • Allow users to dismiss or hide sponsored content

Next Steps