Company Logo API documentation

Table of content

Introduction

CompaniesLogo.com provides access to over 7,000 logos of publicly listed companies through its API.
Our API enables you to integrate those logos into your website, app, or software.
See also the API pricing and the API terms of service.

Best practices

Please follow the following best practices:

Method 1: Download the entire database

👍 Recommended method

It is possible to download a full export of the CompaniesLogo database in JSON format.
Idealy this could be done once daily through cronjob, the resulting JSON file is about 7 MB big (September 2022).
To do so the API query is as described bellow:

https://companieslogo.com/api/1.0/?getAll&api_key=<your_api_key>

JSON response:

[
    {
        "name":"Microsoft",
        "symbol":"MSFT",
        "other_symbols":"MSFT34.SA,MSFT.BA,MSFT.MX,MSF.DE,MSFT.VI,MSFT.SN,MSF.BR,MSF.F,MSFT,MSFT.NE,MSF0.F,0QYP.IL",
        "website_domain":"microsoft.com",
        "country":"United States",
        "last_update":"1662767992",
        "png":
        {
            "icon":
            {
                "for_bright_background":
                {
                    "32":"\/img2\/32\/MSFT-779f50ac742d46f1cf2e1b7-b46250e0.png?t=1662767992",
                    "64":"\/img2\/64\/MSFT-779f50ac742d46f1cf2e1b7-d3962c7e.png?t=1662767992",
                    "80":"\/img2\/80\/MSFT-779f50ac742d46f1cf2e1b7-d8da1056.png?t=1662767992",
                    "128":"\/img2\/128\/MSFT-779f50ac742d46f1cf2e1b7-97a80bbe.png?t=1662767992",
                    "orig":"\/img2\/orig\/MSFT-779f50ac742d46f1cf2e1b7-c6332b12.png?t=1662767992"}
                },
            "big":
            {
                "for_bright_background":
                {
                    "192":"\/img2\/192\/MSFT-779f50ac742d46f1cf2e1b7-ec2ddade.png?t=1662767992",
                    "256":"\/img2\/256\/MSFT-779f50ac742d46f1cf2e1b7-907d73b5.png?t=1662767992",
                    "512":"\/img2\/512\/MSFT-779f50ac742d46f1cf2e1b7-4718e98c.png?t=1662767992",
                    "orig":"\/img2\/orig\/MSFT_BIG-779f50ac742d46f1cf2e1b7-11caff05.png?t=1662767992"
                }
            }
        }
    },
    ....
]

Method 2: Search for a specific company

It is also possible to search for a specific's company logo with its stock symbol.

Find a company by its stock symbol example:

http://companieslogo.staging/api/1.0/?symbol=EDIT&api_key=<your_api_key>

Find a company by its website domain example:

http://companieslogo.staging/api/1.0/?website_domain=editasmedicine.com&api_key=<your_api_key>

JSON response:

{
    "name": "Editas Medicine",
    "symbol": "EDIT",
    "country": "United States",
    "website_domain": "editasmedicine.com",
    "last_update": "1633227240",
    "png": {
        "icon": {
            "for_bright_background": {
                "32": "\/img2\/32\/EDIT-e3b1018c13ec6d39f1a1fb-da66d47b.png?t=1662767908",
                "64": "\/img2\/64\/EDIT-e3b1018c13ec6d39f1a1fb-b113c844.png?t=1662767908",
                "80": "\/img2\/80\/EDIT-e3b1018c13ec6d39f1a1fb-2c2d7be1.png?t=1662767908",
                "128": "\/img2\/128\/EDIT-e3b1018c13ec6d39f1a1fb-b63fa4a9.png?t=1662767908",
                "orig": "\/img2\/orig\/EDIT-e3b1018c13ec6d39f1a1fb-0f583109.png?t=1662767908"
            },
            "for_dark_background": {
                "32": "\/img2\/32\/EDIT.D-e3b1018c13ec6d39f1a1fb-bce0c6da.png?t=1662767908",
                "64": "\/img2\/64\/EDIT.D-e3b1018c13ec6d39f1a1fb-ed24e995.png?t=1662767908",
                "80": "\/img2\/80\/EDIT.D-e3b1018c13ec6d39f1a1fb-fb2dba68.png?t=1662767908",
                "128": "\/img2\/128\/EDIT.D-e3b1018c13ec6d39f1a1fb-19b50e1d.png?t=1662767908",
                "orig": "\/img2\/orig\/EDIT.D-e3b1018c13ec6d39f1a1fb-97ac7208.png?t=1662767908"
            }
        },
        "big": {
            "for_bright_background": {
                "192": "\/img2\/192\/EDIT-e3b1018c13ec6d39f1a1fb-f430e58d.png?t=1662767908",
                "256": "\/img2\/256\/EDIT-e3b1018c13ec6d39f1a1fb-6816ee2e.png?t=1662767908",
                "512": "\/img2\/512\/EDIT-e3b1018c13ec6d39f1a1fb-8a586044.png?t=1662767908",
                "orig": "\/img2\/orig\/EDIT_BIG-e3b1018c13ec6d39f1a1fb-1a31e4dc.png?t=1662767908"
            },
            "for_dark_background": {
                "192": "\/img2\/192\/EDIT_BIG.D-e3b1018c13ec6d39f1a1fb-75e341be.png?t=1662767908",
                "256": "\/img2\/256\/EDIT_BIG.D-e3b1018c13ec6d39f1a1fb-f31bba14.png?t=1662767908",
                "512": "\/img2\/512\/EDIT_BIG.D-e3b1018c13ec6d39f1a1fb-3afadcdb.png?t=1662767908",
                "orig": "\/img2\/orig\/EDIT_BIG.D-e3b1018c13ec6d39f1a1fb-b0a84f35.png?t=1662767908"
            }
        }
    }
}
You can easily test this functionality using the API Playground.

Company Logo API response structure

Depending on your subscription, you might have access to the following fields in your API response:

Image URL structure

The logo URLs are structured in the following way:

/img2/1.192/2.EDIT3._BIG.D-4.e3b1018c13ec6d39f1a1fb-5.75e341be.6.png?7.t=1662767908

1. Logo size (32,64,128, 256, 512 or orig for max resolution)

2. Company main stock symbol, for example: AAPL, TESLA, NVDA

3. This part decides wether the full logo, the icon version, the bright mode or dark mode logo is displayed

4. Public API key. Every image URL is unique to your account.

5. Checksum

6. Logo extension (PNG or SVG)

7. Timestamp of when the logo was last updated / added. Please do not tamper.

Get latest updates

The API call below will return a list of the 500 companies where the logo has been updated or added recently.

http://companieslogo.staging/api/beta2/?last-updated&api_key=<your_api_key>

Technical support

If you have any questions regarding the API integration please send an E-Mail to: inf[email protected]logo.com