Skip to main content
The Unite API lets you create and track ad pre-tests straight from your own system. You send the creative, Unite analyzes it and returns the result: score, pillars, findings and a PDF. You poll the status until the analysis finishes.

Base URL

All calls use HTTPS and JSON. Fields are camelCase, dates are ISO 8601 UTC and ids are opaque: treat them as text, without interpreting them.

What you can do

  • Read the catalog of channels, formats and brands in your workspace.
  • Upload the creative file (image or video).
  • Create out-of-home (OOH), digital (Meta and TikTok) and email pre-tests.
  • Track the status, read the result and download the PDF.
  • Check the workspace pre-test quota.

How it works

  1. A workspace administrator creates an API key in the dashboard.
  2. Your system requests an upload address, uploads the file and creates the pre-test.
  3. Creation responds right away with 202 and the pre-test is queued.
  4. Your system polls the pre-test until the status is completed (or failed).
Pre-tests created through the API show up in the dashboard next to the ones created in the app, and the API also reads the ones created in the app.

Next steps

First pre-test

From zero to PDF, step by step.

Authentication

Keys, permissions, expiry and revocation.

Errors

Every code and how to fix each one.

Results

How to read score, pillars, findings and the PDF.