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.

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 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.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"
    }
}

Sponsors

 

Recommended icon sets

More than 800.000 icons packed in 250 icon sets, Don't miss this huge icon collection by iconshock

Get updates

     

Recent comments

Facebook fans