Developer API

Scalable Vector Icons for Modern Interfaces

Fetch 4,200+ production-ready SVG icons programmatically. REST endpoints, zero-config SDKs, and sub-50ms response times — built for teams shipping fast.

4,218

Icons Available

38ms

Avg. Latency

99.97%

Uptime (2024)

12.4M

API Calls / Day

IconFlow API dashboard showing real-time endpoint metrics and icon delivery stats

Get Started in Minutes

One Endpoint, Every Icon

Authenticate with your API key, then request icons by name, slug, or collection ID. Responses include optimized SVG, metadata, and variant options — all in a single call.

Base URL: https://api.iconflow.dev/v2  |  Auth: Bearer token in Authorization header  |  Rate limit: 600 req/min on Pro plan

// Fetch a single icon by slug
const response = await fetch(
  'https://api.iconflow.dev/v2/icons/arrow-north-east',
  {
    headers: { 'Authorization': `Bearer ${ICONFLOW_API_KEY}` },
  }
);

const icon = await response.json();
// → { slug: "arrow-north-east", svg: "<svg>...", width: 24, height: 24, collection: "essential" }
// Search icons across all collections
const results = await fetch(
  'https://api.iconflow.dev/v2/search?q=settings&limit=12&style=outline',
  {
    headers: { 'Authorization': `Bearer ${ICONFLOW_API_KEY}` },
  }
);

const { icons, total } = await results.json();
// → { icons: [...], total: 47 }
// Retrieve an entire collection (e.g., "essential" pack)
const collection = await fetch(
  'https://api.iconflow.dev/v2/collections/essential?format=zip',
  {
    headers: { 'Authorization': `Bearer ${ICONFLOW_API_KEY}` },
  }
);

// → 248 icons, ~1.2 MB gzipped, ready for build-step bundling

Tip: Use the Accept: application/json header for metadata-only responses (no SVG payload) when building icon pickers or design systems. Cuts bandwidth by ~85%.

Supported SDKs

Official client libraries handle auth, caching, and pagination out of the box.

JavaScript / TypeScript

@iconflow/sdk — npm package with ESM, CommonJS, and Deno support. Tree-shakeable icon imports.

React & Next.js

@iconflow/react<Icon /> component with lazy loading, SSR-safe rendering, and automatic deduplication.

Swift & Kotlin

IconFlowKit — native iOS and Android libraries. Integrates with SwiftUI and Jetpack Compose icon systems.

Real-World Applications

Built for How Teams Ship

From SaaS dashboards to mobile apps, the IconFlow API powers icon delivery at every layer of the stack.

Mobile App Iconography

Preload icon bundles for offline use. The Swift and Kotlin SDKs cache icon sets locally, so your React Native or Flutter app renders icons instantly — even on airplane mode. Used by 340+ mobile teams on the Pro plan.

Dynamic Icon Pickers

Power a searchable icon library inside your CMS or no-code builder. The search endpoint supports fuzzy matching, style filtering (outline, filled, duotone), and collection scoping — perfect for Wix, Webflow, or Framer plugin integrations.

Performance Monitoring

Track icon load times and bundle impact with the X-IconFlow-Metrics response header. Shipper and Vercel teams use this to set Lighthouse budgets — keeping icon payloads under 12 KB per page load, consistently.

Pricing Tiers

Start free. Scale when your traffic demands it.

Hobby

Free forever for personal projects and prototypes.

  • 100 requests / minute
  • 200 icons / month
  • SVG + JSON formats
  • Community support

Enterprise

Custom limits, SSO, and dedicated support for scale.

  • Custom rate limits
  • Private icon collections
  • SLA guarantee (99.99%)
  • Dedicated account manager
  • On-premise sync option