Developer docs

Base URL#

https://mta.growthdept.ai/api/v1

Every request is for one brand and sends two headers: the API key in Authorization and the brand id in Data-Client-ID. An owner or admin creates keys in the app, under Settings > API Keys. Authentication covers keys and scopes.

Exports are asynchronous: you create one, poll its result, then download its files from signed links. MTA has no outbound webhooks today, so your code polls for results on its own schedule. Getting started walks through the whole loop with curl.

Start#

Set up a key and make your first export.

• Getting startedCreate a key, make a first request and download an export, all with curl.
• AuthenticationThe two request headers, API keys, scopes, and the difference between 401 and 403.

API reference#

Each endpoint with its fields, examples and status codes.

• API referenceEvery endpoint with its method, path and scope.
• Read the accountThe brand a key belongs to, with its time zone, currency, models and windows.
• List attribution modelsThe model ids an export request can use.
• List metricsEvery metric id an export can request, with its label.
• List breakdownsThe four breakdown keys and the values the brand's data carries for each.
• Create an exportStart an export for a period, level, models, windows and metrics.
• Get an export resultAn export's status and, once it has finished, its download links.
• Download an export fileFetch one CSV file from a signed link and check that it arrived whole.
• Send ordersSend orders from a store that is not on Shopify, or from your own backend.
• Send spendSend daily ad spend for platforms MTA has no connector for.
• Send matched viewsSend ad views a partner has matched to the orders they led to.

Concepts#

What the numbers mean, and how the API behaves at scale.

• Attribution modelsModels, windows, accounting modes, and how credit adds up to the store's total.
• MetricsEvery export metric with its CSV column, format, and whether it carries data.
• Files and paginationHow a large export arrives as several files, and what the list endpoints return.
• Rate limitsRequest limits per key, size limits per request, and what a 429 looks like.
• ErrorsError bodies, every status code the API returns, and when to retry.

Guides#

Connecting your store and ad platforms, and what changed when.

• ConnectionsSetup guides for Shopify and each ad platform.
• Custom eventsWhat a custom event counts, how its conversions are credited, and when a change shows.
• ChangelogChanges to the API, by date.