Zum Inhalt springen
IconHub
⌘K
AnmeldenKostenlos beitreten
Entwickler

Die IconHub-API

Suche, passe an und liefere Icons direkt aus deinem eigenen Produkt. Kostenlos mit einem API-Schlüssel, mit Fair-Use-Limits, die die API für alle schnell halten.

API-Schlüssel erstellenEndpunkt-Referenz
REST + JSONBereinigtes SVG inlineAVIF-VorschauenKostenlos mit API-Schlüssel300 Anfragen/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"
Antwort
{
  "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
}

Schnellstart

1Schlüssel holenMelde dich an und erstelle unten einen Schlüssel. Bewahre ihn serverseitig auf; er gehört nie in Browser-Code.
export ICONHUB_KEY="ih_live_…"
2SuchenFinde Icons nach Stichwort, Typ, Form, Farbe und Stil. Fordere svg mit with= an, um das Markup direkt mitzubekommen.
GET /icons?search=weather&type=Sticker&with=styles
3RendernBinde den bereinigten svg_code inline ein oder nutze static_image_url für eine fertige AVIF-Vorschau.
<img src="https://storage.iconhub.com/icons/sun-….avif" width="24" alt="Sun">

Endpunkte

Basis-URL https://admin.iconhub.com/api/v1 · sende dein Token als Authorization: Bearer … mit Accept: application/json. Listen liefern data + pagination; Detailaufrufe liefern { status, message, data }. Unbekannte Query-Parameter liefern 422.

Parameter
searchstringNach Relevanz sortierte Volltextsuche, tolerant gegenüber Tippfehlern
typeenumIcon, Sticker, InterfaceIcon, AnimatedIcon
colors[]name[]Farbnamen aus /colors, z. B. Blue
shapes[]name[]Outline, Fill, Lineal Color, Hand Drawn
styles[]slug[]Stil-Slugs aus /styles
tagslugTag-Slug
packslugNur Icons aus diesem Pack
sort_bystringname, created_at, downloads, views
page / per_pageintSeitengröße bis 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" } ] }

Deine API-Schlüssel

Schlüssel sind an dein Konto gebunden. Beschränke jeden auf die Domains, die ihn verwenden.

Anmelden, um Schlüssel zu erstellenEin kostenloses Konto bietet dir bis zu 10 Schlüssel, Beschränkungen pro Domain und ein Nutzungs-Dashboard.
Schlüssel erstellen

Fair Use

Kostenlos, mit Fair UseDie API kostet nichts. 300 Anfragen pro Minute und Schlüssel. Kontaktiere uns, wenn du mehr brauchst.
NamensnennungZeige „Icons von IconHub“ mit einem Link in der Nähe der Icons in deinem Produkt.
CachingAntworten enthalten ein ETag; sende If-None-Match, um 304-Antworten zu erhalten. Spiegele die Bibliothek nicht und lade sie nicht massenhaft über die API herunter.