AdAlign API

Integrate ad-to-landing page analysis into your tools, scripts, and AI agents. Evaluate alignment programmatically with our REST API.

Getting Started

1Be on the Scale plan or above. Every plan starts with a demo.
2Go to Settings → API Keys and create a new key.
3Include the key as a Bearer token: Authorization: Bearer adal_...

Authentication

Bearer Token

Send your API key as a Bearer token in the Authorization header. API keys start with adal_ and draw from your account's monthly evaluation quota. Requests without a key are treated as anonymous (1 evaluation per IP per month).

Authorization: Bearer adal_xK3mR7vN2pQw9...

Quick Start

curl -X POST https://app.adalign.io/api/analyze-ad \
  -H "Authorization: Bearer adal_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "adData": {
      "imageUrl": "https://example.com/ad.png",
      "platform": "meta"
    },
    "landingPageData": {
      "url": "https://example.com/landing"
    }
  }'

Endpoints

POST/api/analyze-ad

Run an ad-to-landing page alignment evaluation using AI vision analysis.

Scope: analyze

GET/api/check-usage

Check remaining evaluations and current tier information.

Scope: usage

GET/api/user-history

List past evaluations with scores and metadata.

Scope: history

GET/api/fixes?action=list&evaluationId=...

List, fetch or count the fixes generated for an evaluation.

Scope: fixes

Full OpenAPI spec available at /api/openapi

Rate Limits

Plan	Evaluations / month	API Keys
Scale€75k–€250k/mo total ad spend	1,500	20
Portfolio€250k–€750k/mo total ad spend	Per contract	50
EnterpriseOver €750k/mo total ad spend	Per contract	50

API access is included on the Scale plan and above. API calls draw from the same monthly pool as the app; failed evaluations are refunded. Limits reset on the 1st of each month (UTC).

Error Codes

Status	Meaning
400	Bad input: unsafe URL, no ad image or URL, or the ad URL could not be captured (see `errorCode`)
401	Invalid, expired or revoked API key (history and fixes also require one)
403	API key lacks required scope
404	Evaluation or fix not found (or owned by another account)
429	Monthly evaluation limit reached
500	Analysis failed; safe to retry, and the evaluation is not counted