Icons as a
service
All of macOSicons.com, one simple API call away.
30,000+ macOS app icons at your fingertips.
Use cases
From Raycast extensions to app directories to icon customization tools — here's what people are actually building with the API.
App launcher autocomplete
As users type in your Raycast extension or custom launcher, pull matching icons in real time.
Team software catalog
Perfect for a company wiki or internal tools hub. Fetch the icon for every app so each entry looks sharp and consistent.
App directories and discovery sites
Running a curated list of Mac apps? Pull icons dynamically for every entry instead of hunting down and hosting screenshots yourself.
App customization tools
Let users browse and apply custom macOS app icons from within your app.
Make icons, not busywork
Generate icons with AI, make any image app-icon compliant, and ship Xcode-ready .icns, Icon Composer and asset catalog files — right from your own tools, no Mac required.
App icon mask
Make any image app-icon compliant. One call trims your artwork to its true edges, refits it inside the macOS squircle grid and applies the app-icon mask, so non-standard icons come out perfectly compliant. PNG or WebP, any size, optional background.
POST /editor/maskAI icon generation
Describe an icon and get a batch of AI-generated options, each automatically made standard-compliant — as a squircle app icon or a real macOS folder.
POST /editor/generate.icns conversion — no Mac needed
Send any image and get back a ready-to-ship macOS .icns with the full standard size set, optionally conformed to the squircle and shadow standard first. It also works in reverse: extract every PNG from an existing .icns.
POST /editor/convert · /editor/extractXcode-ready exports
Turn artwork into an Icon Composer .icon bundle (drag it straight into Xcode 26 or later) or a complete AppIcon.appiconset for your asset catalog — macOS, iOS or both, with App Store-safe flattening for iOS.
POST /editor/icon · /editor/iconsetOne-call release kit
One request, one zip: .icns, Windows .ico, Xcode .appiconset, Icon Composer bundle and a full web favicon pack (manifest and HTML snippet included) — the call your CI makes on every release. Each format is also available on its own.
POST /editor/pack · /faviconPreviews and palettes
Render your icon into a Dock, iPhone Home Screen or desktop mockup for App Store screenshots and launch posts — every scene, in light and dark, in one call. Put it on a gradient, your own wallpaper or a blur of the icon's own colors. Plus color analysis: dominant color, palette and ready-to-use fills.
POST /editor/preview · /paletteGet started in 30 seconds
One curl command away from thousands of icons.
curl -X POST 'https://api.macosicons.com/api/v1/search' \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{"query": "Safari"}'
# Response
{
"hits": [
{
"appName": "Safari",
"lowResPngUrl": "https://...",
"icnsUrl": "https://...",
"iOSUrl": "https://...",
"category": "Browser",
"credit": "Elías",
"creditUrl": "https://...",
"downloads": 7523
}...
],
"query": "Safari",
"totalHits": 42,
"limit": 10,
"offset": 0,
"page": 1,
"totalPages": 4,
}Your API key is waiting
Log in to get instant access to your dashboard and API key.
Sign up or sign in
With an account you'll be able to submit new icons, view their approval status and more.