Skip to Content
API referenceDelivery (tag traffic)

Delivery endpoints

These endpoints are called by the Adzen tag running in the end user’s browser, not by your server. You do not integrate against them directly; they are listed so you can recognise the traffic your pages generate and allow it through your Content Security Policy.

All of them sit under /dea on the same host as the rest of the API:

https://api.adzen.ai/dea/...

Endpoints

EndpointMethodWhat it does
/dea/url/keywordsPOSTFetches ads for the current page
/dea/url/placementsPOSTRequests ad placements for the current page
/dea/url/impressionPOSTDisplay-ad impression beacon
/dea/url/placements/failuresPOSTReports a placement that failed to render
/dea/url/hoverPOSTHover engagement signal
/dea/ugc/impressionGET, POSTUGC ad impression beacon
/dea/healthGETLiveness check

Allow CORS preflight

Every POST from the browser is preceded by an OPTIONS preflight. If you set a Content Security Policy, allow api.adzen.ai in connect-src, and make sure no proxy or firewall blocks OPTIONS requests to it. If the preflight fails, the browser never sends the real request and no delivery call succeeds.

Partner APIs are a different surface

The endpoints above are the delivery path. The APIs you call from your own backend are documented separately and use X-API-Key:

  • UGC — POST /v1/ugc/process
  • AI — POST /v1/ai/process
  • Ad Manager — coming soon
Last updated on