Lottie Animation Preview & Validator (PNG, GIF, Bodymovin)
Pricing
from $10.00 / 1,000 animation analyzeds
Use when an AI coding agent or a developer must see and check a Lottie animation (Bodymovin JSON or .lottie): PNG keyframes, contact sheet, short GIF, plus a structured report of errors and features unsupported on iOS, Android or web. No browser. $0.01 per animation.
index
Optional
Position of the animation in the input (urls first, then lottieJson), from 0.
source
Optional
The URL as given (without any signature or token parameter for uploaded files), or "inline #" (n from 1) for lottieJson items.
sourceType
Optional
Where the animation came from.
format
Optional
Detected from the content, not the extension: json or dotlottie. null when the content was not recognized.
status
Optional
ok: read and rendered (billed). render_failed: read and reported but no image could be produced (free). The others are free failures: invalid_input (bad URL or item), fetch_failed (network, HTTP error, non-public address), robots_disallowed, too_large, invalid_file (not JSON or not a valid dotLottie), not_lottie (JSON that is not a Lottie animation).
error
Optional
null when status is ok. Otherwise one English sentence with the cause.
name
Optional
Animation name (nm) or null.
lottieVersion
Optional
Bodymovin version (v) or null.
width
Optional
Canvas width (w) of the animation. null unless status is ok or render_failed.
height
Optional
Canvas height (h) of the animation.
frameRate
Optional
Frames per second (fr).
inPoint
Optional
First frame (ip).
outPoint
Optional
End frame (op), exclusive: the last shown frame is op - 1.
totalFrames
Optional
op - ip.
durationSeconds
Optional
(op - ip) / fr, rounded to 3 decimals.
sizeBytes
Optional
Size in bytes of the animation JSON (for a dotLottie: the chosen animation, uncompressed).
counts
Optional
layers (including layers of precompositions), precompositions, imageAssets, textLayers, fonts, expressions, effects (effects carried by a layer), masks.
specValid
Optional
Conformance to the official lottie-spec 1.0.1 JSON Schema. Many older Bodymovin exports are non-conformant but play everywhere, so read issues first.
summary
Optional
Number of issues in the list by severity: errors, warnings, infos.
issues
Optional
Up to 100 issues, most severe first. Each has severity (error, warning, info), code (stable), feature (for UNSUPPORTED_FEATURE, else null), unsupportedIn (web, android, ios), count, paths (first 5 JSON pointers), layerNames and an English message that says what to fix.
issuesTruncated
Optional
true when more than 100 issues existed and the least severe were dropped.
compatibility
Optional
For web, android and ios: sorted list of features known to be unsupported. An empty list means no known incompatibility from the built-in table, not that the player is compatible.
preview
Optional
null unless status is ok. renderer (ThorVG version), background (effective), sheetUrl (contact sheet PNG), gifUrl (null when the GIF is off) and frames: one entry per key frame with percent, frame, timeSeconds, width, height, blank (true when fully transparent before the background) and url.
