AdAlign API

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

Getting Started

1Create an account and subscribe to a Growth plan or above.
2Go to Settings → API Keys and create a new key.
3Include the key as a Bearer token: Authorization: Bearer adal_...

Authentication

Bearer Token

All API requests require a Bearer token in the Authorization header. API keys start with adal_ and consume from your monthly evaluation quota.

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"
    },
    "audienceData": {
      "ageRange": "25-34",
      "gender": "all",
      "interests": "marketing"
    }
  }'

Endpoints

POST/api/analyze-ad

Run an ad-to-landing page alignment evaluation using GPT-4o 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=...

Get AI-generated optimization suggestions for a specific evaluation.

Scope: fixes

Full OpenAPI spec available at /api/openapi

Rate Limits

Plan	Evaluations	API Keys
Growth	50/month	5
Agency	200/month	20
Enterprise	1,000/month	50

API calls consume from the same monthly pool as browser evaluations. Limits reset on the 1st of each month.

Error Codes

Status	Meaning
401	Invalid or missing API key
403	API key lacks required scope
429	Monthly evaluation limit reached
500	Internal server error