Ir al contenido
IconHub
⌘K
Iniciar sesiónÚnete gratis
Desarrolladores

La API de IconHub

Busca, personaliza y sirve iconos desde tu propio producto. Gratis con una clave de API, con límites de uso razonable que la mantienen rápida para todos.

Crear una clave de APIReferencia de endpoints
REST + JSONSVG saneado en líneaVistas previas AVIFGratis con una clave de API300 solicitudes/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"
Respuesta
{
  "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
}

Inicio rápido

1Consigue una claveInicia sesión y crea una clave más abajo. Guárdala en el servidor; nunca debe ir en código del navegador.
export ICONHUB_KEY="ih_live_…"
2BuscaEncuentra iconos por palabra clave, tipo, forma, color y estilo. Pide svg con with= para recibir el código en línea.
GET /icons?search=weather&type=Sticker&with=styles
3RenderizaInserta el svg_code saneado en línea, o usa static_image_url para una vista previa AVIF lista.
<img src="https://storage.iconhub.com/icons/sun-….avif" width="24" alt="Sun">

Endpoints

URL base https://admin.iconhub.com/api/v1 · envía tu token como Authorization: Bearer … con Accept: application/json. Las listas devuelven data + pagination; las llamadas de detalle devuelven { status, message, data }. Las claves de consulta desconocidas devuelven 422.

Parámetros
searchstringBúsqueda de texto completo ordenada por relevancia, tolerante a erratas
typeenumIcon, Sticker, InterfaceIcon, AnimatedIcon
colors[]name[]Nombres de color de /colors, p. ej. Blue
shapes[]name[]Outline, Fill, Lineal Color, Hand Drawn
styles[]slug[]Slugs de estilo de /styles
tagslugSlug de la etiqueta
packslugSolo iconos de este pack
sort_bystringname, created_at, downloads, views
page / per_pageintTamaño de página hasta 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" } ] }

Tus claves de API

Las claves están vinculadas a tu cuenta. Restringe cada una a los dominios que la usan.

Inicia sesión para crear clavesUna cuenta gratuita te da hasta 10 claves, restricciones por dominio y un panel de uso.
Crear una clave

Uso razonable

Gratis, con uso razonableLa API no cuesta nada. 300 solicitudes por minuto y clave. Contáctanos si necesitas más.
AtribuciónMuestra «Iconos de IconHub» con un enlace cerca de donde aparezcan los iconos en tu producto.
CachéLas respuestas incluyen un ETag; envía If-None-Match para recibir 304. No repliques ni descargues la biblioteca en masa a través de la API.