Welcome to the Advalidation API

Advalidation lets you programmatically upload and test display and video ad creatives. Use the TypeScript SDK to get started in minutes, or call the REST API directly for full control.

The quick way: TypeScript SDK

import { Advalidation } from "advalidation";

const client = new Advalidation({ apiKey: "your-api-key" });

const result = await client.validate({
  url: "https://example.com/ad.html",
  type: "display",
});

console.log(result.passed);    // true or false
console.log(result.issues);    // number of failed tests
console.log(result.reportUrl); // link to the full visual report

Zero dependencies. One call. All results. See the SDK guide for the full setup.

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.

REST API

The API follows REST conventions with predictable, resource-oriented URLs, JSON request and response bodies, and standard HTTP response codes. See the getting started guide for a step-by-step walkthrough.

Get started

All requests require an API key. Contact your account manager to get one.

AI coding assistants

Working with an AI coding assistant? Download our llms-full.txt and add it to your project context. It contains everything your assistant needs to generate working integration code, including endpoints, authentication, request/response schemas, and workflow examples. For a shorter overview, see llms.txt.

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