GET /api/iconsets/download

Hold on, Young Man!

There's a new version of our API docs.

API operation Download returns icon's image generated by specified criteria.

Request

GET /api/iconsets/download?id=%id%&format=%format%&color=%color%&size=%size%&filename=%filename%

%id% - the icon’s id

%format% - the format of image which you'd like to receive

%color% - hexadecimal color as RRGGBB *

%size% - the size of bitmap image in pixels, actual only when format=png. Minimal value is 1, maximum value is 4000 pixels.

%filename% - optional filename of image.

* Hexadecimal color "RRGGBB" mean the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. All values must be between 0 and FF. For example, the 0000FF value is rendered as blue, because the blue component is set to its highest value (FF) and the others are set to 0.

Possible values of %format% are:

%format% Meaning
pngBitmap images in PNG format (Portable Netword Graphics)
svg.editableVector images in SVG format (Scalable Vector Graphics) with preserved shapes for easy editing
svg.simplifiedVector images in SVG format (Scalable Vector Graphics) with merged shapes for using with web-fonts
epsVector images in EPS format (Encapsulated PostScript)
pdfVector images in PDF format (Portable Document Format)

Example

curl "https://api.icons8.com/api/iconsets/download?id=1&format=svg.editable&color=ff0000&filename=apple.svg"
curl "https://api.icons8.com/api/iconsets/download?id=1&format=svg.simplified&color=ff0000&filename=apple.svg"
curl "https://api.icons8.com/api/iconsets/download?id=1&format=eps&color=ff0000"
curl "https://api.icons8.com/api/iconsets/download?id=1&format=pdf&color=ff0000"
curl "https://api.icons8.com/api/iconsets/download?id=1&format=png&size=100&color=ff0000"

Response

As a result, browser will download file.