REST API

Autenticación

Cada solicitud necesita una clave API. Crea una en tu página de perfil y envíala en la cabecera X-API-Key. Authorization: Bearer … también funciona.

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

Límites de uso

Cada clave puede hacer 1,000 solicitudes por hora. Las solicitudes anónimas comparten un límite menor por dirección IP. Cada respuesta incluye X-RateLimit-Limit; si lo superas, recibes HTTP 429.

Formato de respuesta

Las respuestas son JSON con un campo data y, en las listas, un campo meta con la paginación.

{
  "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/es/icon/fingerprint"
    }
  ],
  "meta": { "page": 1, "per_page": 24, "total": 173, "total_pages": 8 }
}

GET /icons

Lista los iconos publicados. Admite los mismos filtros que el sitio web.

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

GET /icons/{id or slug}

Un icono con etiquetas, licencia y código SVG (iconos gratis o iconos premium que posee tu cuenta).

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

GET /categories

Todas las categorías con su número de iconos.

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

GET /search?q=

Búsqueda de texto completo en nombres, etiquetas, palabras clave y categorías. También admite los filtros de /icons.

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

Errores

Los errores usan códigos de estado HTTP estándar con un cuerpo como {"error": {"code": 401, "message": "…"}}: 401 si falta la clave o no es válida, 403 para contenido premium que no posees, 404 cuando no hay resultados y 429 cuando superas el límite.