# Iconify Icons API
> The open-source icon universe — Iconify — as an API. Search across 200,000+ icons from 200+ icon sets (Material Symbols, Material Design Icons, Font Awesome, Tabler, Lucide, Phosphor, Simple Icons, brand logos and more); get any icon's SVG path, dimensions and a ready-to-use, copy-paste `<svg>` string plus a direct .svg URL; and browse the icon sets with their author, license and icon count. Every icon is addressed by a simple `prefix:name` id (e.g. mdi:home, logos:github). Live from the official api.iconify.design. Ideal for design tools and icon pickers, no-code and website builders, documentation and component libraries, and any app that needs scalable icons. Open-source icons, each with its set's license.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/iconify-api/..."
```

## Pricing
- **Free** (Free) — 3,590 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 48,400 calls/Mo, 8 req/s
- **Pro** ($13/Mo) — 236,000 calls/Mo, 20 req/s
- **Mega** ($35/Mo) — 1,194,000 calls/Mo, 50 req/s

## Endpoints

### Iconify

#### `GET /v1/collections` — Browse icon sets

**Parameters:**
- `q` (query, optional, string) — Filter sets by name/prefix/category Example: `material`
- `limit` (query, optional, string) — Results (1-300)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iconify-api/v1/collections?q=material"
```

**Response:**
```json
{
    "data": {
        "count": 8,
        "query": "material",
        "total": 8,
        "collections": [
            {
                "name": "Material Symbols Light",
                "total": 15483,
                "author": "Google",
                "prefix": "material-symbols-light",
                "license": "Apache 2.0",
                "palette": false,
                "samples": [
                    "downloading",
                    "privacy-tip",
                    "filter-drama-outline",
                    "assignment-ind",
                    "monitoring",
                    "desktop-access-disabled-outline-sharp"
                ],
                "category": "Material"
            },
            {
                "name": "Material Symbols",
                "total": 15409,
                "author": "Google",
                "prefix": "material-symbols",
                "license": "Apache 2.0",
                "palette": false,
                "samples": [
                    "downloading",
                    "privacy-tip",
                    "filter-drama-outline",
                    "assignment-ind",
                    "monitoring",
                    "desktop-access-disabled-outline-sharp"
                ],
                "category": "Material"
            },
            {
                "name": "Google Material Icons",
                "total": 10955,
                "author": "Material Design Authors",
                "prefix": "ic",
        
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/icon` — Icon SVG + metadata

**Parameters:**
- `id` (query, required, string) — Icon id in prefix:name form, e.g. mdi:home Example: `mdi:home`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iconify-api/v1/icon?id=mdi%3Ahome"
```

**Response:**
```json
{
    "data": {
        "icon": {
            "id": "mdi:home",
            "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\"><path fill=\"currentColor\" d=\"M10 20v-6h4v6h5v-8h3L12 3L2 12h3v8z\"/></svg>",
            "body": "<path fill=\"currentColor\" d=\"M10 20v-6h4v6h5v-8h3L12 3L2 12h3v8z\"/>",
            "name": "home",
            "width": 24,
            "height": 24,
            "prefix": "mdi",
            "css_url": "https://api.iconify.design/mdi.css?icons=home",
            "svg_url": "https://api.iconify.design/mdi:home.svg",
            "view_box": "0 0 24 24",
            "iconify_url": "https://icon-sets.iconify.design/mdi/home/"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T14:05:59.172Z",
        "request_id": "90be5537-76f1-43c5-9f04-b8421792bc5f"
    },
    "status": "ok",
    "message": "Icon retrieved",
    "success": true
}
```

#### `GET /v1/search` — Search icons

**Parameters:**
- `q` (query, required, string) — Search term, e.g. home Example: `home`
- `prefix` (query, optional, string) — Restrict to one icon set, e.g. mdi
- `limit` (query, optional, string) — Results (1-100)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iconify-api/v1/search?q=home"
```

**Response:**
```json
{
    "data": {
        "count": 32,
        "query": "home",
        "total": 32,
        "results": [
            {
                "id": "material-symbols:home",
                "name": "home",
                "prefix": "material-symbols",
                "svg_url": "https://api.iconify.design/material-symbols:home.svg"
            },
            {
                "id": "material-symbols:home-outline",
                "name": "home-outline",
                "prefix": "material-symbols",
                "svg_url": "https://api.iconify.design/material-symbols:home-outline.svg"
            },
            {
                "id": "material-symbols:home-outline-rounded",
                "name": "home-outline-rounded",
                "prefix": "material-symbols",
                "svg_url": "https://api.iconify.design/material-symbols:home-outline-rounded.svg"
            },
            {
                "id": "material-symbols:home-rounded",
                "name": "home-rounded",
                "prefix": "material-symbols",
                "svg_url": "https://api.iconify.design/material-symbols:home-rounded.svg"
            },
            {
                "id": "material-symbols-light:home",
                "name": "home",
                "prefix": "material-symbols-light",
                "svg_url": "https://api.iconify.design/material-symbols-light:home.svg"
            },
            {
                "id": "material-symbols-light:home-outline",
                "name": "ho
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & options

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/iconify-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Live Iconify data. /v1/search = search 200k+ icons (optionally within one set via prefix=); /v1/icon = an icon's SVG body, dimensions and a ready-to-use <svg> string (id is prefix:name, e.g. mdi:home); /v1/collections = browse the icon sets with their author, license and icon count. Each icon also has a direct .svg URL.",
        "source": "Iconify — the open-source icon framework (api.iconify.design)",
        "endpoints": [
            "/v1/search",
            "/v1/icon",
            "/v1/collections",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T14:05:59.325Z",
        "request_id": "760ec4ab-89bc-4d31-b5e0-e2c66220d3e4"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/iconify-api
OpenAPI spec: https://www.oanor.com/api/iconify-api/openapi.json