How Adams AI Works

Complete technical documentation on how Adams AI processes your marketing data and delivers AI-powered insights.

🏗️ Platform Architecture

Adams AI is built on a modern, cloud-native architecture designed for scale, reliability, and performance:

•Next.js 15 with App Router - Server-side rendering for optimal performance and SEO
•PostgreSQL Database - ACID-compliant relational database with advanced indexing
•Prisma ORM - Type-safe database operations with automatic migrations
•NextAuth.js v5 - Enterprise-grade authentication and session management
•TypeScript - Full type safety across the entire stack

Our processing pipeline follows a sophisticated multi-stage approach:

Step 1

Account Connection - Users securely connect their Meta, Google Ads, or TikTok accounts via OAuth 2.0

Step 2

Data Ingestion - Real-time data synchronization from advertising platforms using official APIs

Step 3

AI Analysis - Machine learning models process metrics for anomalies, trends, and optimization opportunities

Step 4

Insight Generation - Actionable recommendations delivered in real-time dashboard

Real-time campaign performance metrics with 100+ data points per advertisement. Includes CTR, CPC, ROAS, conversion tracking, and audience insights.

Machine learning engine provides budget optimization, audience targeting suggestions, and creative performance predictions based on historical data.

Manage unlimited ad accounts across multiple platforms in a single unified dashboard. Supports up to 50K campaigns per workspace.

Export reports as CSV, PDF, or JSON. API endpoints available for custom integrations with BI tools and marketing automation platforms.

Meta Ads

API v18+

Google Ads

API v14+

TikTok Ads

API v1.4+

LinkedIn Ads

API v2.0+

Base URL: https://api.adamai.io/v1

GET /accounts - List connected accounts

GET /accounts/:id/campaigns - Get campaign data

POST /insights/analyze - Get AI insights

GET /reports/export - Export data