Welcome to the Advalidation API

The Advalidation API lets you programmatically upload and test display and video ad creatives. It follows REST conventions with predictable, resource-oriented URLs, JSON request and response bodies, and standard HTTP response codes.

What you can test

Display creatives — hosted images, HTML5 bundles, and third-party tags. Tests check dimensions, file size, animation length, CPU usage, load performance, click tracking, SSL compliance, and more. See the full test reference for the complete list.

Video creatives — hosted video files and VAST tags (including tags with multiple media files and rotating variations). Tests check resolution, duration, bitrate, codec, audio loudness, and more. For VAST, additional checks validate XML structure, skip behavior, media file declarations, and connection rules. See the full test reference for the complete list.

How it works

1. Create a campaign and choose an ad specification (the ruleset that defines pass/fail criteria)
2. Upload a creative — a URL, HTML tag, VAST tag, or binary file
3. Poll until the scan finishes (typically under 30 seconds)
4. Retrieve test results with pass, fail, or warn for each check

Get started

All requests require an API key. Contact your account manager to get one, then follow the getting started guide to make your first API call.

If you have questions or feedback, please get in touch.