GET /api/iconsets/category

Hold on, Young Man!

There's a new version of our API docs.

API operation Category returns information about one specified category and the list of icons in it.

Request

GET /api/iconsets/category?category=%category%&amount=%amount%&platform=%platform%&attributes=%attributes%

GET /api/iconsets/category?category=%category%&amount=%amount%&platform=%platform%

GET /api/iconsets/category?category=%category%&amount=%amount%&offset=%offset%&platform=%platform%

GET /api/iconsets/category?category=%category%&amount=%amount%

%category% - the name of the icons' category, case insensitive

%amount% - the maximum number of icons which you'd like to receive

%offset% - the offset from the first received result; default is 0

%platform% - the platform that we are searching icons for

%attributes% - icon's special attributes, like "filled" or "outlined"

Possible values of %platform% are:

%platform% Meaning
win8Collection of icons in the Microsoft Windows 8/Metro style
win10Collection of icons in the Microsoft Windows 10/Threshold style
ios7Collection of icons in the Apple iOS 7 style
androidCollection of icons in the Google Android 4 Kitkat style
androidLCollection of icons in the Google Android 5 Lollipop style
colorCollection of color flat icons

If the %platform% parameter is not specified or has an invalid value, the search will be performed within all icons’ platforms.

Possible values of %attributes% are:

%attributes% Meaning
outlinedOutlined icons
filledFilled icons

If the %attributes% parameter is not specified or has an invalid value, the search will be performed within all icons regardless of their attributes.


Example

curl "https://api.icons8.com/api/iconsets/category?category=Animals&amount=10"
curl "https://api.icons8.com/api/iconsets/category?category=Animals&amount=10&platform=ios7"
curl "https://api.icons8.com/api/iconsets/category?category=Animals&amount=10&offset=10&platform=ios7"

Response

Link to Icons8 and use icons for free or Buy license

<?xml version="1.0" encoding="UTF-8" ?>
	
        
		
			
				Most popular icons
				
				
				
				
					
					
						
						
						
					
                     
                        Animals
                        Pets
                    
                    Animals 
					 
						
					
				
				...
				...
				https://cdn.icons8.com/previews/20141229103442/win8/previews/Animals_preview.png
			
		

        
        error details