API service 1.1

Integrate IconFinder into your website or application with the API.

Get started

To start using the API, you will need an API key. You will get one by signing up and grabbing your API key. Make sure that your read the API terms of service.

Support and reporting bugs

If you need support or report a bug you can go to our feedback page

API methods

Search for icons by search term. Returns icon matches sorted by relevance.

Params

q: Search term
p: Specify result page (index). Starts from 0
c: Number of icons per page. (Takes values between 1 and 50)
l: Filter on license. Takes the following values:
- 0 - include all icons
- 1 - includes only icons with commercial licenses
- 2 - includes only icons with commercial license which does not require a link to designer's website.
min: Specify minimum size of icons
max: Specify maximum size of icons
api_key: An Iconfinder API key
callback: Name of callback function (JSONP)

Example (XML)

E.g. http://www.iconfinder.com/xml/search/?q=user&c=10&p=0&min=1&max=48&api_key=123456789

Result (XML)

<results for="test" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/">
    <opensearch:Query role="request" searchTerms="test" startPage="0"/>
    <opensearch:totalResults>424</opensearch:totalResults>
    <opensearch:startIndex>0</opensearch:startIndex>
    <opensearch:itemsPerPage>2</opensearch:itemsPerPage>
    <iconmatches>
        <icon>
            <id>14305</id>
            <size>16</size>
            <image>http://www.iconfinder.com/data/icons/iconset/filename.png</image>
        </icon>
        <icon>
            <id>15484</id>
            <size>16</size>
            <image>http://www.iconfinder.com/data/icons/iconset/filename.png</image>
        </icon>
    </iconmatches>
</results>

Example (JSON)

E.g. http://www.iconfinder.com/json/search/?q=user&c=10&p=0&min=1&max=48&api_key=123456789

Result (JSON)

{
    "searchresults": {
        "searchTerms": "user",
        "startPage": 0,
        "totalResults": 424,
        "startIndex": 0,
        "itemsPerPage": 2,
        "icons": [
            {
                "id": "1447",
                "size": "32",
                "image": "http:\/\/icons3.iconfinder.comdna-cdn.com\/data\/icons\/nuvola2\/32x32\/apps\/personal.png"
            },
            {
                "id": "36090",
                "size": "32",
                "image": "http:\/\/icons3.iconfinder.comdna-cdn.com\/data\/icons\/fatcow\/32x32_0460\/group.png"
            }
        ]
    }
} Get information about an icon.

Params

id: Icon ID
size: Icon size
api_key: An Iconfinder API key
callback: Name of callback function (JSONP)

Example (XML)

E.g. http://www.iconfinder.com/xml/icondetails/?id=1&size=128&api_key=123456789

Result (XML)

<icon>
    <tags>
        <tag>kmenu</tag>
    </tags>
    <author>Lothar Grimme</author>
    <authorwebsite>http://www.grafixport.org</authorwebsite>
    <license>GPL</license>
    <licensewebsite>http://www.gnu.org/copyleft/gpl.html</licensewebsite>
    <iconsetwebsite>http://www.grafixport.org</iconsetwebsite>
    <attribution>Text from readme file</attribution>
    <iconset>Carpelinx</iconset>
    <iconsetid>bnw</iconsetid>
    <additionalsizes>
        <icon>
            <id>1</id>
            <size>16</size>
            <image>http://www.iconfinder.com/data/icons/bnw/16x16/apps/1_kmenu.png</image>
        </icon>
        <icon>
            <id>1</id>
            <size>22</size>
            <image>http://www.iconfinder.com/data/icons/bnw/22x22/apps/1_kmenu.png</image>
        </icon>
    </additionalsizes>
</icon>

Example (JSON)

E.g. http://www.iconfinder.com/json/icondetails/?id=1&size=128&api_key=123456789

Result (JSON)

{
    "icon": {
        "tags": [
            "kmenu"
        ],
        "author": "Lothar Grimme",
        "authorwebsite": "http:\/\/www.grafixport.org",
        "license": "GPL",
        "licensewebsite": "http:\/\/www.gnu.org\/copyleft\/gpl.html",
        "iconsetwebsite": "http:\/\/www.grafixport.org",
        "attribution": "Text from readme file",
        "iconset": "Carpelinx",
        "iconsetid": "bnw"
    }
}

API service 1.1

Integrate IconFinder into your website or application with the API.

Get started

Support and reporting bugs

API methods

Params

Example (XML)

Result (XML)

Example (JSON)

Result (JSON)

Params

Example (XML)

Result (XML)

Example (JSON)

Result (JSON)

Sponsors

Recent comments

Facebook fans