The Iconfinder API is an HTTP JSON API and allows you to programmatically access resources on the service, such as icons, icon sets, categories, styles, authors, etc. The API is accessible on the domain and always used over HTTPS. It accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authorization, and verbs.

The current version of the API is <<currentVersion>> and while the previous versions are still functional, they are considered deprecated and it is strongly recommended to use v4.

Get started with a new application

If you haven't already, please go create a new application in your account to get the API secret. You will need that when authorizing. When you have the API secret, you are ready to go to authorization.


Help & support

If you have problems using the API, questions or want to upgrade to a paid plan, please contact us on [email protected].

Cross-Origin Resource Sharing (CORS)

The Iconfinder API version supports Cross-Origin Resource Sharing (CORS) for AJAX requests, independent of the request origin. For usage in Flash-based applications, the Iconfinder API has a cross-domain policy file allowing full access over HTTPS. See for details.

Data types

All data is sent as UTF-8 encoded JSON identified by the media type application/json.

Blank fields, ie. fields whose value would be a JSON null, are omitted to keep the response size to a minimum. All timestamps are returned as strings in the ISO 8601 format of arbitrary precision guaranteed to be in UTC:



Summaries and detailed representations

Depending on the endpoint used, either a summary or a detailed representation of a resource will be returned. Generally, listing and search endpoints such as /<<currentVersion>>/iconsets will return summaries while resource-specific endpoints such as /<<currentVersion>>/iconsets/ will return a detailed representation.

While the levels of detail in the representations differ, detailed representations are guaranteed to at least contain the same information in the same structure as summary representations.


Terms of service

Usage of the Iconfinder API is subject to the API terms of service.