Icons as a
Service
All of macOSicons.com a simple API call away.
25,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 instantly in real time.
Team software catalog
Perfect for a wiki or internal hub of tools for your company. Fetch app icons for every app so each entry looks sharp and consistent.
App directory & 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/generatemacOS, Windows & Linux icons — no Mac needed
Send any image and pick the output: a macOS .icns with the full standard size set (optionally conformed to the squircle + shadow standard first), a multi-size Windows .ico, a Windows kit with the MSIX tile assets, or a Linux kit with a hicolor theme and a .desktop entry. And the reverse: extract every PNG out of an existing .icns.
POST /editor/convert · /editor/extractXcode-ready exports
Turn artwork into an Icon Composer .icon bundle (drag straight into Xcode 26+) 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, a Windows kit (.ico + MSIX assets), a Linux kit (hicolor theme + .desktop), an Xcode appiconset, an Icon Composer bundle and a full web favicon pack (manifest + HTML snippet included) — the call your CI makes on every release. Each format is available standalone too.
POST /editor/pack · /faviconPreviews & 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
Sign in to get instant access to your dashboard and API keys
Sign up or sign in
With an account you'll be able to submit new icons, view their approval status and more.