API Documentation
Integrate app icon data into your applications with our REST API
Free
$0 / forever
- ✓ 100 requests/day
- ✓ 20 icons per request
- ✓ Basic icon data
- ✗ No version history
- ✗ No AI tags & colors
Pro
Popular$8 / month
- ✓ Unlimited requests
- ✓ 100 icons per request
- ✓ Full version history
- ✓ AI analysis tags
- ✓ Extracted color palettes
- ✓ Priority support
Authentication
Include your API key in the X-API-Key header or as api_key query parameter.
curl -H "X-API-Key: your_api_key" \
https://your-domain.com/api/v1/iconsAPI Endpoints
GET
/api/v1/iconsSearch and list icons with various filters
Parameters
qstringSearch query (app name, developer)categorystringFilter by category (e.g., games, social)colorstringFilter by color (e.g., blue, red)stylestringFilter by style (e.g., flat, gradient)moodstringFilter by mood (e.g., professional, playful)pagenumberPage number (default: 1)limitnumberItems per page (free: max 20, pro: max 100)GET
/api/v1/icons/:idGet detailed information about a specific icon
GET
/api/v1/categoriesList all available categories with icon counts
GET
/api/v1/similarFind visually similar icons using perceptual hashing
Parameters
idstringIcon ID to find similar icons forphashstringPerceptual hash to search (alternative to id)limitnumberMaximum results (default: 10, max: 20)Example Response
{
"success": true,
"data": [
{
"id": "com.instagram.ios",
"name": "Instagram",
"category": "social",
"iconUrl": "https://...",
"developer": "Meta Platforms, Inc."
}
],
"total": 47000,
"page": 1,
"limit": 20,
"totalPages": 2350,
"_meta": {
"api_version": "v1",
"tier": "free",
"rate_limit": 100,
"rate_remaining": 99
}
}