Introduction

Welcome to the Datamoon public HTTP API reference. These endpoints are for integrations that authenticate with API keys (not the browser dashboard session).

Base URL

All routes are served under your tenant host with the /api prefix:

• Current: https://<your-tenant-host>/api/v2/...

Replace <your-tenant-host> with the domain you use for the Datamoon app (for example your production or staging hostname).

Authentication

There are three patterns, depending on the route:

1. Module / extension API (X-Api-Key) — Used for v2/ext/* and v2/m/* audiences and saved-queries APIs. Send your key in the X-Api-Key header.
2. Legacy user API key (api_key) — Used for pixel, results and enrichment. Pass as the api_key query parameter, form field, or JSON body field.
3. No auth — Topic Search (/v2/b2b-topics/*, /v2/b2c-topics/*) is public.

Issue and manage keys from your Datamoon dashboard.

OpenAPI reference

The full interactive schema is available at API Reference.