Company Logo API documentation

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.

Best practices

Please follow the following best practices:

• Read the API documentation and follow its instructions
• Pull only the data you need, for example check for updates and only download the images you need, don't exceed 5 API requests per second
• Read the terms or service
• Report missing logos or inacuraties

Method 1: Download the entire database

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:

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

Find a company by its website domain example:

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

Find a company by its ISIN example:

https://companieslogo.com/api/1.0/?isin=US0378331005&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"
            }
        }
    }
}

Company Logo API response structure

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

• png
  images in transparent PNG format
• svg
  images in vectorized SVG format
• for_bright_background
  images to display on bright backgrounds
• for_dark_background
  images to display on dark backgrounds (dark mode)
• icon
  Icon version of the logo, suitable to be used in lists or small screens, it may not containg the entire logo features or text
• big
  Logo in full size, displaying all texts and features
• 32
  32x32 resized/cropped logo
• 64
  64x64 resized/cropped logo
• 80
  80x80 resized/cropped logo
• 128
  128x128 resized/cropped logo
• 256
  256x256 resized/cropped logo
• 512
  512x512 resized/cropped logo
• orig
  high resolution logo, (not resized)

Image URL structure

The logo URLs are structured in the following way:

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

2. Company main stock symbol, for example: AAPL, TSLA, 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.

https://companieslogo.com/api/1.0/?last-updated&api_key=<your_api_key>

Technical support

If you have any questions regarding the API integration please send an E-Mail to: infnospamo@companies(nospam)logo.com