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/generate.icns conversion — no Mac needed
Send any image, get back a ready-to-ship macOS .icns with the full standard size set — optionally conformed to the squircle + shadow standard first. And the reverse: extract every PNG out of an existing .icns.
POST /editor/icns · /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/iconsetGet 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
macOSicons API
Please sign in to your macOSicons.com account
