Architecture at a Glance
Your system interacts with two services that share a single API key:| Service | Base URL | Responsibilities |
|---|---|---|
| File API | files.adclear.ai | File upload (resumable chunked uploads); upload status tracking |
| Integration API | public-api.adclear.ai | Promotions, evaluations, reference data, outbound webhooks |
Key Concepts
| Concept | Description |
|---|---|
| Promotion | A piece of marketing/promotional content submitted for compliance review |
| Version | An immutable snapshot of uploaded files within a promotion. Version 1 is created with the promotion; subsequent versions represent revisions |
| Evaluation | An asynchronous compliance review of a specific version. Produces a set of issues with cited rules |
| Webhook | An outbound HTTP POST from Adclear to your endpoint when an event occurs (e.g. evaluation completes) |
| Metadata | An arbitrary key-value map you attach at promotion creation. It is stored and echoed back in every webhook so you can correlate events to your own entities |
Supported File Formats
| Format | MIME Type | Max Size | Notes |
|---|---|---|---|
application/pdf | 30 MB | Most common; multi-page supported | |
| PNG | image/png | 30 MB | Single image |
| JPEG | image/jpeg | 30 MB | Single image |
| WebP | image/webp | 30 MB | Single image |
| MP4 | video/mp4 | 2 GB | Video content |
| MOV | video/quicktime | 2 GB | Video content |
| MP3 | audio/mpeg | 2 GB | Audio content |
| WAV | audio/wav | 2 GB | Audio content |
| DOCX | application/vnd.openxmlformats-officedocument.wordprocessingml.document | 10 MB | Document |
| XLSX | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | 10 MB | Spreadsheet |
| HTML | text/html | N/A | Web/email content |
| Text/HTML (inline) | N/A | N/A | Inline via content field; no file upload required |