1
Send one URL
One GET request with the page’s address. No browser to run, no scraper to write.
Design Extraction API
Lottie API
GET /v1/lottie3 credits/callPull the Lotties from any website
The Lottie extraction API: find and download the Lottie files on any website from its URL, in one GET request. No other API does this.
- 300 free credits a month
- Failed and repeat calls are free
- Works from ChatGPT, Claude and Cursor
1 GET
one request per URL
JSON
ready-to-play output
Only one
no other API detects Lottie
How it works
From a URL to data you can use
2
MiroMiro reads the live page
It reads the page’s HTML and CSS as a visitor’s browser would, and collects what the page really uses.
3
Get it back, ready to use
Typed JSON, for 3 credits. A repeat call within 24 hours is free.
One call
The API is the demo
One authenticated GET against any live URL. Typed JSON back.
Terminal
GET /v1/lottie$
⠿ fetching lottiefiles.com…
{
"lotties": [
{"url": "https://…/hero.json",
"source": "lottie-player" },
{"url": "…/loader.json", "source": "data-lottie" }
], "count":2
}
200 OK · 0.7s · 3 credits
Playing · hero.json
loop
hero.jsonlottie-playerloader.jsondata-lottieCoverage
What it captures
Found on the page
- lottie-player
- dotlottie
- .lottie files
- .json animations
- data attributes
Why this one
No competing extraction API exposes Lottie detection - this is the only one that does.
Compare alternativesParameters
What you can pass
Only url is required. Everything else narrows or reshapes the result.
urlrequired
any public URL
The page to extract from. With or without protocol (https:// is assumed).
fields
lotties · count · note
Comma-separated list of fields to return (e.g. fields=lotties).
render
true · false (default)
Load the page in a real browser and run its JavaScript before extracting.
fresh
true · false (default)
Skip the 24-hour cache and re-extract from the live page.
screenshot
true · full · false (default)
Requires render=true. The same real browser that renders the page also captures a screenshot - true for the 1440x900 viewport, full for the entire page height.
Every parameter, the response fields and the error codes are in the reference.
Agent-ready
Your agent can call this
“Find the Lottie animations on lottiefiles.com and add the hero one to my project.”
Step-by-step setup for your agent
ChatGPT
Claude
Claude Code
Codex
Cursor
Grok Bot
OpenAI dots
MuseUse cases
What you can build
Recover animations
Pull the Lottie files from a legacy or reference site instead of rebuilding them.
Hand it to your agent
Give a coding agent the exact animation a reference site uses.
Animation libraries
Index and catalogue Lottie usage across many sites programmatically.
FAQ
Before you integrate
What is a Lottie file?
A Lottie is a lightweight JSON animation format (from Airbnb’s bodymovin) played by lottie-web, lottie-react, and similar players. This API returns the JSON file URLs a page declares.
Does it find every Lottie on a page?
It finds Lotties declared in the initial HTML (lottie-player, dotlottie-player, data attributes, .lottie/.json references). Most Lotties are injected at runtime instead - add render=true and the page loads in a real browser with its JavaScript executed first, so those show up too (+5 credits).
What does it cost?
Lottie extraction is 3 credits per call. Failed and cached requests are never billed. Start free with no card.
Does it work on sites built with JavaScript?
Yes. The page’s HTML and CSS are read first, which is enough for most sites. When a page only builds itself with JavaScript, or refuses a plain request, it is re-read in a real browser automatically at no extra cost. Add render=true to force the browser, for example for images that load on scroll: that costs 5 extra credits, on every plan including the free key.
Can it read pages behind a login?
No. It reads public pages the way a visitor without an account would see them. Pages that need a sign-in, and addresses on your own machine such as localhost, are out of reach.
Can my AI agent call it without code?
Yes. The same call is the extract_lottie tool on the MiroMiro MCP server. Connect ChatGPT, Claude, Cursor, Codex or another agent once, with a sign-in and no API key, and ask in plain language.
More about the Lottie Extraction API
Pull Lottie animations from any live URL
The MiroMiro Lottie Extraction API detects and returns the Lottie animation files a webpage declares - lottie-player and dotlottie-player elements, .lottie and .json references, and data-attribute animation sources - in a single GET request. Point it at any public URL and get back clean JSON with the animation file URLs, ready to download or feed into a player.
Built for developers and AI coding agents
Instead of rebuilding a reference animation by hand, hand your Cursor or Claude Code agent the exact Lottie a site uses. The response is typed and predictable, so you can index Lottie usage across many sites, recover animations from a legacy build, or catalogue a whole animation library programmatically.
Get your free API key
300 free credits every month, no credit card. One key unlocks every endpoint - brand, tokens, images, SVGs, fonts, and Lottie. Upgrade only when you outgrow the free tier.