Skip to content
IconHub
⌘K
Sign inJoin free
Developers

The IconHub API

Search, customize and serve icons from inside your own product. Free with an API key, with fair-use limits that keep it fast for everyone.

Create an API keyEndpoint reference
REST + JSONSanitized SVG inlineAVIF previewsFree with an API key300 req/min
curl "https://admin.iconhub.com/api/v1/icons?search=heart&with=svg,styles&per_page=20" \
  -H "Authorization: Bearer $ICONHUB_TOKEN" \
  -H "Accept: application/json"
Response
{
  "data": [
    { "id": 14162379, "type": "Icon", "name": "Heart", "slug": "heart",
      "static_image_url": "https://storage.iconhub.com/icons/heart-14162379.avif",
      "svg": { "svg_code": "<svg …>" }, "styles": [{ "name": "Lineal", "slug": "lineal" }] }
  ],
  "pagination": { "current_page": 1, "last_page": 11733, "limit": 20, "total": 234649 },
  "related_tags": [{ "text": "love", "slug": "love" }],
  "search_degraded": false
}

Quickstart

1Get a keySign in and create a key below. Keep it server-side; it never belongs in browser code.
export ICONHUB_KEY="ih_live_…"
2SearchFind icons by keyword, type, shape, color and style. Ask for svg with with= to get markup inline.
GET /icons?search=weather&type=Sticker&with=styles
3RenderInline the sanitized svg_code, or use static_image_url for a ready-made AVIF preview.
<img src="https://storage.iconhub.com/icons/sun-….avif" width="24" alt="Sun">

Endpoints

Base URL https://admin.iconhub.com/api/v1 · send your token as Authorization: Bearer … with Accept: application/json. Lists return data + pagination; detail calls return { status, message, data }. Unknown query keys return 422.

Parameters
searchstringRanked full-text search, typo-tolerant
typeenumIcon, Sticker, InterfaceIcon, AnimatedIcon
colors[]name[]Color names from /colors, e.g. Blue
shapes[]name[]Outline, Fill, Lineal Color, Hand Drawn
styles[]slug[]Style slugs from /styles
tagslugTag slug
packslugOnly icons in this pack
sort_bystringname, created_at, downloads, views
page / per_pageintPage size up to 100
withstringsvg, styles, colors, tags, packs, variants, similars
GET https://admin.iconhub.com/api/v1/icons?search=heart&shapes[]=Outline&with=svg,styles&per_page=40

{ "data": [ { "slug": "heart", "name": "Heart", "svg": { "svg_code": "<svg …>" } } ],
  "pagination": { "current_page": 1, "last_page": 5867, "limit": 40, "total": 234649 },
  "related_tags": [ { "text": "love", "slug": "love" } ] }

Your API keys

Keys are tied to your account. Restrict each one to the domains that use it.

Sign in to create keysA free account gives you up to 10 keys, per-domain restrictions and a usage dashboard.
Create a key

Fair use

Free, with fair useThe API costs nothing. 300 requests per minute per key. Contact us if you need more.
AttributionShow “Icons by IconHub” with a link near where icons appear in your product.
CachingResponses carry an ETag; send If-None-Match to get 304s. Don't mirror or bulk-download the library through the API.
Developers — the IconHub API · IconHub