Iconify for Pagenflow

Documentation

No SDK, no API key, no rate-limit headaches — every endpoint below is a plain HTTP GET request you can call directly from a browser, a backend, or an email template. Want to explore visually first? Head to Browse.

Search icons

GET /api/search

Full-text style search across every icon name. Supports pagination and optional filtering to a single collection. Response includes a nextCursor field — pass it back as cursor to fetch the next page. Prefer this over incrementing page when walking through many pages back to back (e.g. downloading the whole icon set): page jumps to an arbitrary page by counting up to it internally, so it gets slower the deeper you go, while cursor seeks directly to where you left off regardless of depth. nextCursor is null once there's nothing more to fetch.

  • term Substring to match against icon names (optional)
  • collection Restrict results to one collection prefix, e.g. mdi (optional)
  • page 1-indexed page number, defaults to 1
  • limit Results per page, defaults to 32
  • cursor Opaque token from a previous response's nextCursor; fetches the page right after it (optional)
GET /api/search?term=home&collection=mdi&page=1&limit=32
GET /api/search?limit=100&cursor=eyJuIjoiaG9tZSIsImki...

Render an icon

GET /api/image/{height}/{color}/{rotate}/{iconFullName}.{svg|png}

Renders a single icon as an SVG or PNG. iconFullName is "prefix:name" (e.g. mdi:home) and must be URL-encoded because of the colon. color is a 6-digit hex value without the #. rotate is degrees, optionally suffixed with -ccw for counter-clockwise (e.g. 90-ccw).

  • height Output height in pixels, e.g. 64
  • color 6-digit hex color without #, e.g. 2563eb
  • rotate Rotation in degrees, e.g. 0, 90, 90-ccw
  • iconFullName URL-encoded prefix:name, e.g. mdi%3Ahome, plus .svg or .png
GET /api/image/64/2563eb/0/mdi%3Ahome.svg

List collections

GET /api/collections

Returns every icon collection (Material Design Icons, Tabler, Phosphor, ...) with icon counts. Supports filtering by category id.

  • category Restrict to one collection category id (optional)
GET /api/collections

Get a single collection

GET /api/collections/{prefix}

Returns metadata for one collection: author, license, counts, and category.

  • prefix Collection prefix, e.g. mdi
GET /api/collections/mdi

Browse icons in a collection

GET /api/collections/{prefix}/icons

Paginated icons scoped to one collection, with optional search term and icon-category filtering.

  • prefix Collection prefix, e.g. mdi
  • term Substring to match against icon names (optional)
  • category Restrict to one icon category id within the collection (optional)
  • page 1-indexed page number, defaults to 1
  • limit Results per page, defaults to 32
GET /api/collections/mdi/icons?term=arrow

List collection categories

GET /api/collections/categories

Returns the top-level categories collections are grouped under (e.g. General, Emoji, Brands), each with a collection count.

GET /api/collections/categories

List icon categories in a collection

GET /api/collections/{prefix}/icons/categories

Returns the icon sub-categories defined within one collection.

  • prefix Collection prefix, e.g. mdi
GET /api/collections/mdi/icons/categories