---
canonical_url: "https://docs.composio.dev/toolkits/icons8"
markdown_url: "https://docs.composio.dev/toolkits/icons8.md"
product: "platform"
version: null
last_updated: null
---

# Icons8

Access the Icons8 Icons API to browse icon metadata, categories, and platforms and retrieve SVG source for licensed icons.

- **Category:** images & design
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `ICONS8`
- **Version:** 00000000_00

## Tools

### Get Icon Metadata

**Slug:** `ICONS8_GET_ICON_METADATA`

Return metadata for one Icons8 icon without SVG source or download-allocation use. This is a metered meta request; provider preview URLs are returned without being fetched.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon_id` | string | Yes | Icons8 icon ID returned by ICONS8_SEARCH_ICONS. |
| `language` | string | No | Result locale in lowercase-language/uppercase-region form, for example en-US. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Icon SVG

**Slug:** `ICONS8_GET_ICON_SVG`

Return one icon's metadata and SVG source as untrusted text. This consumes the separate download-request allocation. Do not execute scripts, follow embedded links, or render the SVG in a privileged DOM without sanitization. Icons8 terms still apply: use requires an applicable active API License, API results must not be cached or stockpiled, and API access does not grant stand-alone redistribution rights. Review the provider's API License; this warning is not legal advice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `icon_id` | string | Yes | Icons8 icon ID returned by ICONS8_SEARCH_ICONS. |
| `language` | string | No | Result locale in lowercase-language/uppercase-region form, for example en-US. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Icon Categories

**Slug:** `ICONS8_LIST_CATEGORIES`

Return one bounded page of Icons8 icon categories, nested subcategories, icon counts, a relative share-preview path, and style-specific preview icon names. This is a metered meta request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-based page number (1-10,000 toolkit cap). Omit when using offset. |
| `limit` | integer | No | Categories to return in this page (1-100). The 100 maximum is a conservative toolkit cap; Icons8 documents no maximum. |
| `offset` | integer | No | Categories to skip from the start (0-1,000,000 toolkit cap). Omit when using page. |
| `language` | string | No | Result locale in lowercase-language/uppercase-region form, for example en-US. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Icon Platforms and Styles

**Slug:** `ICONS8_LIST_PLATFORMS`

Return one bounded page of Icons8 platform/style codes, names, color and size metadata, icon counts, preview icon names, and a preview URL. This is a metered meta request; provider URLs are returned without being fetched.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-based page number (1-10,000 toolkit cap). Omit when using offset. |
| `limit` | integer | No | Platforms/styles to return in this page (1-100). The 100 maximum is a conservative toolkit cap; Icons8 documents no maximum. |
| `offset` | integer | No | Platforms/styles to skip from the start (0-1,000,000 toolkit cap). Omit when using page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Icons

**Slug:** `ICONS8_SEARCH_ICONS`

Return one bounded page of Icons8 icon metadata filtered by style, category, language, explicit-content inclusion, and animation state. Optionally include tags in each returned icon's metadata. This is a metered meta request; it returns provider URLs without fetching them.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-based page number (1-10,000 toolkit cap). Omit when using offset. |
| `limit` | integer | No | Icons to return in this page (1-100). The 100 maximum is a conservative toolkit cap; Icons8 documents no maximum. |
| `offset` | integer | No | Icons to skip from the start (0-1,000,000 toolkit cap). Omit when using page. |
| `category` | string | No | Category API code returned by ICONS8_LIST_CATEGORIES. |
| `language` | string | No | Result locale in lowercase-language/uppercase-region form, for example en-US. |
| `platform` | string | No | Platform/style API code returned by ICONS8_LIST_PLATFORMS. |
| `is_animated` | boolean | No | Set true for animated icons only or false for static icons only; omit for either. |
| `additional_fields` | string | No | Set to tags to include each icon's tags; tags are otherwise omitted. |
| `include_explicit_content` | boolean | No | Whether results may include explicit icons. Omit to leave provider behavior unchanged; the prose docs say true by default but Swagger declares no default. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
