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 contacting us. Please describe what you need it for - commercial or personal purposes.

Support and reporting bugs

If you need support or report a bug you can use this Google group.

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 100)
• l: Filter on license (0 include all icons. 1 includes only icons with commercial licenses)
• 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.net/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.net/data/icons/iconset/filename.png</image>
        </icon>
        <icon>
            <id>15484</id>
            <size>16</size>
            <image>http://www.iconfinder.net/data/icons/iconset/filename.png</image>
        </icon>
    </iconmatches>
</results>

Example (JSON)

E.g. http://www.iconfinder.net/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.netdna-cdn.com\/data\/icons\/nuvola2\/32x32\/apps\/personal.png"
            },
            {
                "id": "36090",
                "size": "32",
                "image": "http:\/\/icons3.iconfinder.netdna-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.net/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.net/data/icons/bnw/16x16/apps/1_kmenu.png</image>
        </icon>
        <icon>
            <id>1</id>
            <size>22</size>
            <image>http://www.iconfinder.net/data/icons/bnw/22x22/apps/1_kmenu.png</image>
        </icon>
    </additionalsizes>
</icon>

Example (JSON)

E.g. http://www.iconfinder.net/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"
    }
}