Icons8 Image URLs API

Base URL

https://img.icons8.com

Authentication

No API key for the image URLs. The free tier requires visible attribution linking to icons8.com; paid plans remove that requirement.

Rate limit

No published limit. Icons are CDN-cached and immutable per URL.

Pricing

Free with attribution. Paid plans remove the link-back requirement and add formats and sizes.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 21 Aug 2026, and the response shown is the real body it returned — not an illustration.

curl 'https://img.icons8.com/color/48/home.png'

const res = await fetch("https://img.icons8.com/color/48/home.png");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://img.icons8.com/color/48/home.png", timeout=20)
res.raise_for_status()
print(res.json())

# This endpoint returns image/png, not JSON.
# The response body is the image itself, so it can be used directly as an
# <img src="..."> or saved to a file — there is nothing to parse.
#
# Verified: HTTP 200, Content-Type: image/png

(body)image/png

The rendered icon. Requesting a `.svg` extension returns `image/svg+xml` instead, which can be recoloured with CSS.

Content-Typeheader

Reflects the extension you requested.

(CORS)header

A permissive Access-Control-Allow-Origin header is sent, so canvas access works.

(missing icon)behaviour

An unknown name or unavailable style returns an error rather than a fallback icon.

• Drop icons into a prototype with no build step
• Use icons in HTML email, where icon fonts and sprites do not work
• Serve icons into a no-code or low-code tool that only accepts URLs
• Compare visual styles quickly by swapping one path segment

If Icons8 Image URLs does not fit, these photography & design apis cover similar ground. Every one was called before publishing, and each links to its own reference page with a working curl command and the response it returned.