v1.0.0 — 429+ Premium SVG Icons

IconVault
API

The ultimate SVG icon REST API. Access 429+ icons from 278 brands with rate limiting, multiple variants, and blazing-fast responses.

javascript
fetch('/api/icons?limit=5&category=Social')
  .then(res => res.json())
  .then(data => console.log(data));
Discord
Figma
Docker
Cloudflare
Adobe
Airbnb
Angular
Deno_dark
429+
Total Icons
278
Brands
2000/IP
Rate Limit
<50ms
Response
Why IconVault?

Built for Developers

Everything you need to integrate premium SVG icons into your projects, with no complexity.

Blazing Fast
Sub-50ms response times with optimized CDN delivery and efficient caching. Get SVG icons instantly without any noticeable delay.
Rate Limited
2,000 requests per IP per 15-minute window with standard rate limit headers. Fair usage guaranteed with transparent rate limit policies.
Multiple Variants
Each brand includes standard, dark, light, and wordmark variants. Over 5 variant types available for maximum flexibility in your designs.
Smart Search
Search icons by name, category, or slug with instant fuzzy matching. Filter by category and variant to find exactly what you need.
RESTful API
Clean, well-documented RESTful endpoints with JSON responses and optional raw SVG output. Follows OpenAPI best practices.
CDN Powered
All icons served directly from GitHub CDN with global edge distribution. Reliable and fast delivery no matter where your users are.
Browse Icons

429+ Premium Icons

Explore our comprehensive collection of brand icons across multiple categories and variants.

Showing 0 icons
API Reference

Documentation

Complete API reference with examples. All endpoints return JSON with consistent structure.

Rate Limiting

All API endpoints are rate-limited to 2,000 requests per IP per 15-minute window. When the limit is exceeded, the API returns a 429 Too Many Requests response with a retry_after field indicating when you can resume requests.

X-RateLimit-Limit
Maximum requests allowed (2000)
X-RateLimit-Remaining
Requests remaining in current window
X-RateLimit-Reset
ISO timestamp when the window resets
X-RateLimit-Policy
Policy string: "2000;w=900"
GET/api/icons
List all available icons with pagination, search, and category filtering.

Parameters

NameTypeDescription
pagenumberPage number (default: 1)
limitnumberItems per page, max 100 (default: 20)
categorystringFilter by category (e.g., Social, Programming)
variantstringFilter by variant type (standard, dark, light, wordmark)
searchstringSearch icons by name or slug

Response Example

json
{
  "success": true,
  "data": {
    "icons": [...],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 278,
      "total_pages": 14,
      "has_next": true,
      "has_prev": false
    }
  },
  "meta": {
    "total_icons": 429,
    "total_brands": 278,
    "categories": [...]
  }
}
GET/api/icons/{slug}
Get detailed information about a specific icon, including all available variants and download URLs.

Parameters

NameTypeDescription
slugstringIcon slug (e.g., Discord, React, Google)
variantstringPreferred variant (default: standard)
formatstringSet to "svg" for raw SVG output

Response Example

json
{
  "success": true,
  "data": {
    "name": "Discord",
    "slug": "Discord",
    "category": "Social",
    "available_variants": ["standard"],
    "variants": {
      "standard": {
        "slug": "Discord",
        "url": "...",
        "size": 1217
      }
    }
  }
}
GET/api/icons/search
Search icons by name, slug, or category with instant fuzzy matching.

Parameters

NameTypeDescription
qstringSearch query (required, min 1 character)

Response Example

json
{
  "success": true,
  "query": "react",
  "count": 3,
  "data": [...]
}
GET/api/categories
List all available icon categories with brand and icon counts.

Response Example

json
{
  "success": true,
  "data": [
    {
      "name": "AI & ML",
      "slug": "ai-ml",
      "brand_count": 12,
      "icon_count": 45
    }
  ]
}
GET/api/stats
Get API statistics including total icons, brands, categories, and rate limit info.

Response Example

json
{
  "success": true,
  "data": {
    "total_icons": 429,
    "total_brands": 278,
    "categories_count": 11,
    "rate_limit": {
      "max_requests": 2000,
      "window": "15 minutes"
    }
  }
}

Error Responses

200 OK
Successful request
400 Bad Request
Invalid parameters
404 Not Found
Icon not found
429 Rate Limited
Too many requests
Live Tester

Test Endpoints

Test API endpoints in real-time right from the browser. No API key required.

API Console
GET

Click Send to test an endpoint

Select a preset above or enter a custom URL