Provides criteria scores for media if they are available.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns AI-generated scoring results for a submitted media asset. Only available once the asset's status is COMPLETE. Results are broken down by channel and, optionally, by individual scoring guideline.
Response format options
Control what the response contains with the format query parameter:
| Value | What's returned |
|---|---|
summary (default) | Per-channel rollup: score, adherencePercent, pass/fail counts |
detail | Per-channel summary plus an array of individual guideline results |
summary,detail | Both |
Understanding the numbers
adherencePercent — The straightforward pass rate: what fraction of applicable guidelines this asset passed. Range: 0.0–1.0. This is the most interpretable number for most integrations.
score — A weighted aggregate: SUM(passed_points) / SUM(total_points). Because guidelines have different weights, this number differs from adherencePercent. Range: 0.0–1.0.
Per-guideline result values
Each guideline in a detail response carries one of these result values:
| Result | Meaning |
|---|---|
PASS | The creative met this guideline. |
FAIL | The creative did not meet this guideline. |
NOT_APPLICABLE | The guideline doesn't apply to this creative type or channel. |
NO_DATA | The asset hasn't been tagged or analyzed yet. |
NO_DATA_MEDIA_NOT_TAGGED | Specific reason: the asset is missing required tags. |
Guideline weight vs. consideration
Each guideline has a numeric weight and a legacy consideration field (MANDATORY / OPTIONAL). For new integrations, use weight to determine how much a guideline impacts the rolled-up channel score — higher weight means greater influence. The consideration field is preserved for backward compatibility only.
Filtering results
Use the channel query parameter to filter results to specific platforms (e.g. channel=META,TIKTOK). If omitted, all scored channels are returned.