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 api.iconfinder.com
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 https://api.iconfinder.com/crossdomain.xml 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:
<YYYY>-<MM>-<DD>T<HH>:<MM>:<SS>Z
<YYYY>-<MM>-<DD>T<HH>:<MM>:<SS>.<mmm>Z
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.