Aller au contenu
IconHub
⌘K
Se connecterRejoindre gratuitement
Développeurs

L’API IconHub

Recherchez, personnalisez et servez des icônes depuis votre propre produit. Gratuit avec une clé d’API, avec des limites d’usage raisonnable qui la gardent rapide pour tout le monde.

Créer une clé d’APIRéférence des endpoints
REST + JSONSVG assaini en ligneAperçus AVIFGratuit avec une clé d’API300 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"
Réponse
{
  "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
}

Démarrage rapide

1Obtenez une cléConnectez-vous et créez une clé ci-dessous. Gardez-la côté serveur ; elle n’a jamais sa place dans du code navigateur.
export ICONHUB_KEY="ih_live_…"
2RecherchezTrouvez des icônes par mot-clé, type, forme, couleur et style. Demandez svg avec with= pour recevoir le balisage en ligne.
GET /icons?search=weather&type=Sticker&with=styles
3AffichezInsérez le svg_code assaini en ligne, ou utilisez static_image_url pour un aperçu AVIF prêt à l’emploi.
<img src="https://storage.iconhub.com/icons/sun-….avif" width="24" alt="Sun">

Endpoints

URL de base https://admin.iconhub.com/api/v1 · envoyez votre jeton via Authorization: Bearer … avec Accept: application/json. Les listes renvoient data + pagination ; les appels de détail renvoient { status, message, data }. Les clés de requête inconnues renvoient 422.

Paramètres
searchstringRecherche plein texte classée par pertinence, tolérante aux fautes
typeenumIcon, Sticker, InterfaceIcon, AnimatedIcon
colors[]name[]Noms de couleur issus de /colors, p. ex. Blue
shapes[]name[]Outline, Fill, Lineal Color, Hand Drawn
styles[]slug[]Slugs de style issus de /styles
tagslugSlug du tag
packslugUniquement les icônes de ce pack
sort_bystringname, created_at, downloads, views
page / per_pageintTaille de page jusqu’à 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" } ] }

Vos clés d’API

Les clés sont liées à votre compte. Restreignez chacune aux domaines qui l’utilisent.

Connectez-vous pour créer des clésUn compte gratuit vous donne jusqu’à 10 clés, des restrictions par domaine et un tableau de bord d’utilisation.
Créer une clé

Usage raisonnable

Gratuit, avec usage raisonnableL’API ne coûte rien. 300 requêtes par minute et par clé. Contactez-nous s’il vous en faut plus.
AttributionAffichez « Icônes par IconHub » avec un lien près de l’endroit où les icônes apparaissent dans votre produit.
Mise en cacheLes réponses portent un ETag ; envoyez If-None-Match pour recevoir des 304. Ne dupliquez pas et ne téléchargez pas la bibliothèque en masse via l’API.