DealDome API Documentation

The DealDome API gives you programmatic access to everything that powers our dropshipping business — Shopify store management, financial tracking, product performance, and AI agent interactions. Built on a Go backend at api.dealdome.eu, the API serves our UK-market Shopify stores, three AI agents (Alfred, Roos, and Elisa), a Telegram bot interface for day-to-day operations, and a Next.js financial dashboard.

Getting started

To start working with the DealDome API, you will need valid credentials — either a JWT token obtained via email/password login or a service API token prefixed with dd_. Head over to the quickstart guide to get the server running locally, or jump straight to authentication to understand how requests are authorized.

Guides

Architecture

Understand how the backend, AI agents, Telegram bots, and dashboard fit together.

Read more

Quickstart

Get the DealDome API running locally with Go, PostgreSQL, and environment variables.

Read more

Authentication

Learn about JWT tokens for team members and API tokens for services.

Read more

AI Agents

Discover how Alfred, Roos, and Elisa work together to power the team.

Read more

Resources

Products

Manage winning products with cost prices, track inventory, and monitor product performance.

Daily Financials

Track daily P&L per store including revenue, COGS, ad spend, and net profit.

Conversations

Access AI agent conversation history, messages, and memory entries.

Settings

Configure API keys, Shopify store connections, and application settings.

Was this page helpful?