Introduction
Beta
The Nexoya API is currently in beta. No SLA is guaranteed during this period.
Nexoya is a cross-channel attribution and optimization platform. It aggregates performance data from 40+ advertising channels, applies privacy-safe regression-based attribution to resolve which touchpoints actually drove conversions, and proposes AI-driven budget reallocations to help marketing teams overachieve their goals — without manual spreadsheet work.
The Nexoya API gives you programmatic access to that same data. Use it to build custom dashboards, automate reporting, feed attribution results into your own BI tools, or power AI assistants/agent with live portfolio and performance data.
What you can do with the API
- Read portfolio structure — list portfolios, their contents (campaigns and ad sets per channel), funnel steps, and labels
- Query performance metrics — aggregated and daily time-series spend, funnel step values, ROAS, and cost-per across all channels
- Access attribution results — compare platform-reported conversions against Nexoya's regression-attributed values, broken down by attribution rule
- Inspect optimization proposals — retrieve the active budget reallocation proposal with baseline vs. predicted metrics per funnel step
- Fetch portfolio events — read performance annotations (promotions, market shifts, etc.) that provide context for metric changes
Core concepts
| Concept | Description |
|---|---|
| Portfolio | A named collection of campaigns and ad sets grouped by strategy or business unit. The central object in the API. |
| Content | A single campaign or ad set from a specific channel, assigned to a portfolio. |
| Channel / Provider | An advertising platform (Google Ads, Meta, LinkedIn, TikTok, etc.). Nexoya connects 40+ providers. |
| Funnel Step | A stage in the customer journey tracked within a portfolio — e.g. Clicks, Leads, Conversions. Each portfolio defines its own funnel. |
| Attribution | Nexoya's regression model redistributes conversions across channels based on actual contribution, replacing last-click or platform-native attribution. |
| Optimization | A budget reallocation proposal generated by Nexoya's AI engine. Compares a baseline (current allocation) against a predicted outcome (proposed reallocation) for each funnel step. |
Requesting access
The API uses OAuth 2.0. Nexoya supports the Client Credentials flow, suitable for server-to-server integrations where a confidential client acts on its own behalf.
To create an application and receive your client_id and client_secret, contact developers@nexoya.com.
Once you have credentials, follow the Client Credentials guide to obtain an access token, then the Authenticated Requests guide to start making API calls.