REST API

Authentification

Chaque requête nécessite une clé API. Créez-en une sur votre page de profil et envoyez-la dans l’en-tête X-API-Key. Authorization: Bearer … fonctionne aussi.

curl -H "X-API-Key: iv_your_key_here" "https://iconfold.com/api/icons?per_page=5"

Limites de débit

Chaque clé peut effectuer 1,000 requêtes par heure. Les requêtes anonymes partagent une limite plus basse par adresse IP. Chaque réponse inclut X-RateLimit-Limit ; au-delà, la réponse est HTTP 429.

Format de réponse

Les réponses sont en JSON avec un champ data et, pour les listes, un champ meta avec la pagination.

{
  "data": [
    {
      "id": 109,
      "name": "Home",
      "slug": "fingerprint",
      "category": "UI & UX",
      "style": "outline",
      "license": "Free for commercial use",
      "premium": false,
      "downloads": 1204,
      "svg_url": "https://iconfold.com/svg/fingerprint.svg",
      "url": "https://iconfold.com/fr/icon/fingerprint"
    }
  ],
  "meta": { "page": 1, "per_page": 24, "total": 173, "total_pages": 8 }
}

GET /icons

Liste les icônes publiées. Accepte les mêmes filtres que le site.

GET https://iconfold.com/api/icons?category=weather&per_page=2

GET /icons/{id or slug}

Une icône avec tags, licence et code SVG (icônes gratuites, ou icônes premium possédées par votre compte).

GET https://iconfold.com/api/icons/fingerprint

GET /categories

Toutes les catégories avec leur nombre d’icônes.

GET https://iconfold.com/api/categories

GET /search?q=

Recherche plein texte dans les noms, tags, mots-clés et catégories. Accepte aussi les filtres de /icons.

GET https://iconfold.com/api/search?q=arrow

Erreurs

Les erreurs utilisent les codes HTTP standard avec un corps du type {"error": {"code": 401, "message": "…"}} : 401 pour une clé absente ou invalide, 403 pour un contenu premium que vous ne possédez pas, 404 si rien ne correspond et 429 si vous dépassez la limite.