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 send a mail support@iconfinder.com

API methods

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

Params

Example (XML)

E.g. https://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>https://www.iconfinder.com/data/icons/iconset/filename.png</image>
        </icon>
        <icon>
            <id>15484</id>
            <size>16</size>
            <image>https://www.iconfinder.com/data/icons/iconset/filename.png</image>
        </icon>
    </iconmatches>
</results>

Example (JSON)

E.g. https://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

Example (XML)

E.g. https://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>https://www.iconfinder.com/data/icons/bnw/16x16/apps/1_kmenu.png</image>
        </icon>
        <icon>
            <id>1</id>
            <size>22</size>
            <image>https://www.iconfinder.com/data/icons/bnw/22x22/apps/1_kmenu.png</image>
        </icon>
    </additionalsizes>
</icon>

Example (JSON)

E.g. https://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"
    }
}