1
Send one URL
One GET request with the page’s address. No browser to run, no scraper to write.
Design Extraction API
Image API
GET /v1/images1 credit/callEvery image a page loads, in one call
The image extraction API: extract every image from a website URL - img, srcset, picture, CSS backgrounds, favicons and og:image - each tagged by where it was found.
- 300 free credits a month
- Failed and repeat calls are free
- Works from ChatGPT, Claude and Cursor
Every source
not just <img> tags
Tagged
by where it was found
1 credit
per call
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 1 credit. 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/images$
⠿ fetching stripe.com…
{
"images": [
{"url": "…/hero@2x.png", "source": "img" },
{"url": "…/globe.webp", "source": "srcset" },
{"url": "…/og.jpg", "source": "og" }, …
], "count":36
}
200 OK · 0.6s · 1 credit
36 images · tagged by source
img
hero@2x.pngsrcset
globe.webppicture
dashboard.pngcss
pattern.svgog
og.jpgfavicon
favicon.icoSources
imgsrcsetpicturecssfaviconogReal output
What it actually returns
A real response for stripe.com, captured from the live API - not a mock.
Images (showing 5 of 40)
From img, srcset, CSS backgrounds and og:image - resolved to absolute URLs and tagged by source.
Coverage
What it captures
Found on the page
- img + srcset
- <picture>
- CSS backgrounds
- favicons
- og:image
Why this one
Catches CSS background-image, favicons, and og:image - sources a plain <img> scrape silently drops.
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
images · count
Comma-separated list of fields to return (e.g. fields=images).
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
“List every image on stripe.com and download the product shots.”
Step-by-step setup for your agent
ChatGPT
Claude
Claude Code
Codex
Cursor
Grok Bot
OpenAI dots
MuseUse cases
What you can build
Asset recovery
Pull every image from a legacy site in one call for a migration.
Brand kits
Assemble product imagery and brand assets programmatically.
Content pipelines
List a page’s images once, then download, moderate or reprocess them downstream.
FAQ
Before you integrate
Which images does it find?
img src and srcset, <picture> sources, CSS background-image, favicons/apple-touch-icons, and og:image / twitter:image - each tagged by where it was found.
What does it cost?
Image extraction is 1 credit per call. Cached and failed calls are free.
Do I need a credit card to try it?
No. A free key includes 300 credits a month - at 1 credit per call, that is 300 pages of images - and the playground needs no signup at all.
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_assets 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 Image Extraction API
Extract all images from any URL
The MiroMiro Image Extraction API lists every image a page loads - img src and srcset, <picture> sources, CSS background-image, favicons and apple-touch-icons, and og:image / twitter:image - as resolved URLs, each tagged by the source it came from. One GET request, complete inventory.
Asset recovery, brand kits, content pipelines
Pull every image from a legacy site in one call for a migration, assemble product imagery and brand assets programmatically, or feed resolved image URLs into downstream processing and moderation. Because CSS backgrounds and og:image are covered, you get the assets a naïve <img> crawl would miss.
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.