Authentication

All Adloom API requests require authentication using an API key. Learn how to create and use keys.

Base URL

All API requests use this base URL:

https://adloom.io/api/v1

Creating API keys

API keys are created in your Adloom dashboard. Follow these steps:

1. Go to Settings: Log in to your dashboard and navigate to Settings from the navigation menu.
2. Select API keys: Find the API keys section in your account settings.
3. Create new key: Click "Create new API key" and give it a descriptive name.
4. Select plan: Choose which API plan this key will use (Scan, Fix, Platform, or Business).
5. Copy key: Copy your API key immediately. You will not be able to view it again.

Security note: Treat your API key like a password. Never commit it to version control or share it publicly.

API key format

Adloom API keys start with the prefix adl_ followed by a random string:

adl_2x4k9m1p8v3q7r9s2t4u6w8y0z1a3b5c7d9e

Authentication methods

Adloom supports two methods for authenticating API requests. Use either method; both are equally secure.

X-API-Key header

Pass your API key in the X-API-Key request header:

curl -X POST https://adloom.io/api/v1/scan \
  -H "X-API-Key: adl_your_api_key_here" \
  -F "file=@creative.zip"

Authorization header

Alternatively, use the Authorization header with Bearer token format:

curl -X POST https://adloom.io/api/v1/scan \
  -H "Authorization: Bearer adl_your_api_key_here" \
  -F "file=@creative.zip"

API plans

Each API key is assigned to a plan that determines which operations and quotas are available.

Plan	Operations	Monthly quota	Overage price
API Scan	Validation only	500 scans	$0.08
API Fix	Scan and fix all platforms	500 scans and fixes	$0.15
API Platform	Scan and fix one platform	1000 scans and fixes	$0.10
API Business	Scan and fix all platforms, batch processing	5000 scans and fixes	$0.06
API Enterprise	Custom endpoints, SLA	Unlimited	Custom

Rate limiting and quotas

Monthly quotas

Each API key has a monthly quota that resets every 30 days from the creation date. Your current usage and quota are available in the dashboard and via response headers.

Quota exceeded

When you exceed your monthly quota, the API returns HTTP 429 (Too Many Requests):

HTTP/1.1 429 Too Many Requests
Content-Type: application/json

{
  "error": "Monthly quota exceeded. Upgrade your plan or wait until quota resets."
}

Response headers

Every API response includes headers showing your quota usage:

X-Adloom-Quota-Limit: 1000
X-Adloom-Quota-Used: 250
X-Adloom-Quota-Remaining: 750
X-Adloom-Quota-Reset: 2026-04-21T14:30:00Z

Next steps

Now that you understand authentication, explore the endpoints:

POST /scan - Validate creatives POST /fix - Validate and fix creatives GET /platforms - List supported platforms Error handling and status codes