API documentation
Adloom provides a REST API for validating, fixing, and batch-processing HTML5 ad creatives. Integrate creative testing directly into your workflow.
Quick start
All requests use the base URL:
https://adloom.io/api/v1
Authenticate with your API key in the request header:
X-API-Key: adl_your_api_key_here
Need an API key? Head to your dashboard settings to create one.
Endpoints
/scan
Validate an HTML5 ad creative
Upload a ZIP file containing your ad creative to receive a comprehensive validation report with 40+ checks including clickTag detection, IAB compliance, and performance metrics.
View documentation/fix
Validate and automatically fix issues
Automatically fix common ad creative issues: clickTag conversion, image compression, JS/CSS minification, backup image generation, and more. Returns a corrected ZIP file.
View documentation/batch/scan
Batch validate up to 50 creatives
Upload multiple ZIP files in a single request and receive individual scan reports plus aggregate statistics. Requires the API Business or Enterprise plan.
View documentation/batch/fix
Batch scan and fix up to 50 creatives
Scan and auto-fix multiple creatives in one call. Returns base64-encoded fixed ZIPs with before/after metrics. Requires the API Business or Enterprise plan.
View documentation/platforms
List supported ad platforms
Get a list of all 11 supported ad platforms with their clickTag formats and specifications. No authentication required.
View documentationAPI plans
API Scan
$79/month, 1,000 scans included, $0.05 per overage
Validation only. Full scan reports and clickTag detection.
API Fix
$199/month, 500 scans and fixes included, $0.25 per overage
Scan and auto-fix for all 11 platforms. Most popular plan.
API Platform
$299/month, 1,000 scans and fixes included, $0.22 per overage
Scan and fix locked to one platform. Target platform set via API key.
API Business
$899/month, 5,000 scans and fixes included, $0.20 per overage
All platforms plus batch endpoint (50 creatives per call) and priority processing.
API Enterprise
Custom pricing
Unlimited volume, custom endpoints, SLA guarantee, dedicated account manager, and on-premise option available.
Core concepts
Authentication
All requests require authentication. See the authentication guide for details on creating and using API keys.
Rate limiting
Each API key has a monthly quota based on your plan. When exceeded, requests return 429 status. Quotas reset on a 30-day billing cycle.
Error handling
Familiarize yourself with error codes and responses. All errors follow a standard JSON format.
White-label reports
Agency plan users can generate PDF reports with custom branding. See the white-label documentation for details on removing Adloom branding and adding your own.
Support
Have questions about the API? Visit our help centre or email support@adloom.io for assistance.