Get ad creative analysis
GET/api/v1/ads/:ad_id/analysis
What this creative is selling, who it targets, and how it reads on brand-safety axes — without running a match. Same values the ad_analysis event of /v1/ads/match carries.
primary_brand / primary_product are the single thing the ad actually advertises; brands / products are every brand or object that appears (a coffee cup beside the advertised laptop lands in products, not primary_product).
Analysis normally runs at registration time, so a ready ad answers 200 straight away. If it hasn't run yet this returns 202 with status: pending and starts it — poll the same URL (a 30s creative takes roughly 30s; minutes-long ones proportionally longer).
Request
Responses
- 200
- 202
- 401
- 403
- 404
- 409
- 422
- 500
Successful Response
Analysis isn't available yet — it was just started. Body carries only ad_id and status: pending; poll this same URL until it returns 200.
Missing or invalid API key. Add Authorization: Bearer vuf_live_<keyid>.<secret>.
Key used outside the public API roots (/api/v1, /api/v1.1).
Referenced resource (video / job / ad) not found.
Ad exists but isn't ready, or has no analyzable media (unknown duration) — polling will never succeed.
Request body failed validation.
Upstream service error — usually safe to retry.