public

GET /v1/public/ads/analytics/export/{token}

One analytics table as CSV or XLSX from the signed download link the ads_analytics_export MCP tool returns (za-286).

All public endpoints

All developer docs →

Zinn®, our Viking, hammering at his anvil beside an API endpoint sending events to several listeners.

Authentication

This endpoint is public. It takes no credential and no organisation — it is what our own marketing site and AI answer engines read.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X GET https://api.zinndigital.com/v1/public/ads/analytics/export/{token}

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

Auth model: no session and no bearer header (security: []) - the path token IS the credential, a signed single-use capability. The view enforces ads.view by proxy: the ads_analytics_export MCP tool checks ads.view on the caller's MCP grant, resolves the caller's organisations exactly as GET /v1/ads/analytics/export does (narrowed by org_id to that organisation and its clients) and stores them, with the filters, on a durable row (AdsExportLink, tenant-scoped by RLS). The link signs (HMAC, Django signing with its own salt) only that row's id, table, file, by, locale, the issuing MCP grant and its organisation, valid for 15 minutes, so its length does not grow with the number of organisations; every signed value must equal the row. The file is the same one exportAdsAnalyticsTable streams. Every unusable link - tampered, expired, the MCP grant that minted it revoked since or no longer covering every organisation on the link (its ads.view scope removed, or an organisation moved out of its subtree: the whole link is refused, never a smaller file; an organisation added since is never added to it), an organisation no longer in good standing, or a table or filter that no longer parses - answers the same 404 (no oracle). A link is single-use: a second download answers 410. Every answer, refusals included, carries Cache-Control: no-store and Referrer-Policy: no-referrer; the token is kept out of access logs, traces and the audit trail. Its own budget (public_ads_analytics_export_link, 120 per hour per address, fails closed).

Parameters

NameTypeRequiredWhat it is
token (path)stringYes—

Errors this endpoint can return

404 · 410 · 429