Stocks & Company Logo API documentation

CompaniesLogo.com provides access to over 11,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

Method 1: Download the Entire Database

Download a full export of the CompaniesLogo database in JSON format. Ideally this could be done once daily through cronjob, the resulting JSON file is about 7 MB big.

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"
                    }
                }
        }
    },
    // additional companies...
]

Method 2: Search for a Specific company Simplest

Search for a specific company's logo using different identifiers:

Find a company by its stock symbol:

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

Find a company by its website domain:

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

Find a company by its ISIN:

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

JSON response Structure

Example of JSON reponse for the company Editas Medicine

{
    "name": "Editas Medicine",
    "symbol": "EDIT",
    "country": "United States",
    "website_domain": "editasmedicine.com",
    "last_update": 1720244491,
    "png": {
        "icon": {
            "for_bright_background": {
                "32": "/img2/32/EDIT-8c209b52e431d534968681-8f40b2d7.png?t=1720244491",
                "64": "/img2/64/EDIT-8c209b52e431d534968681-a833074a.png?t=1720244491",
                "128": "/img2/128/EDIT-8c209b52e431d534968681-6bdc0e2a.png?t=1720244491",
                "orig": "/img2/orig/EDIT-8c209b52e431d534968681-5110b22d.png?t=1720244491"
            },
            "for_dark_background": {
                "32": "/img2/32/EDIT.D-8c209b52e431d534968681-22d595cc.png?t=1720244491",
                "64": "/img2/64/EDIT.D-8c209b52e431d534968681-a5949eaa.png?t=1720244491",
                "128": "/img2/128/EDIT.D-8c209b52e431d534968681-ca840f42.png?t=1720244491",
                "orig": "/img2/orig/EDIT.D-8c209b52e431d534968681-dabd7220.png?t=1720244491"
            }
        },
        "big": {
            "for_bright_background": {
                "192": "/img2/192/EDIT-8c209b52e431d534968681-86f26600.png?t=1720244491",
                "256": "/img2/256/EDIT-8c209b52e431d534968681-d8d8a985.png?t=1720244491",
                "512": "/img2/512/EDIT-8c209b52e431d534968681-e1774f74.png?t=1720244491",
                "orig": "/img2/orig/EDIT_BIG-8c209b52e431d534968681-5cd6090a.png?t=1720244491"
            },
            "for_dark_background": {
                "192": "/img2/192/EDIT_BIG.D-8c209b52e431d534968681-36156a94.png?t=1720244491",
                "256": "/img2/256/EDIT_BIG.D-8c209b52e431d534968681-28bfd358.png?t=1720244491",
                "512": "/img2/512/EDIT_BIG.D-8c209b52e431d534968681-56975b14.png?t=1720244491",
                "orig": "/img2/orig/EDIT_BIG.D-8c209b52e431d534968681-6f950e71.png?t=1720244491"
            }
        }
    },
    "svg": {
        "icon": {
            "for_bright_background": {
                "orig": "/img2/orig/EDIT-8c209b52e431d534968681-f5af7560.svg?t=1720244491"
            },
            "for_dark_background": {
                "orig": "/img2/orig/EDIT.D-8c209b52e431d534968681-9f0db600.svg?t=1720244491"
            }
        },
        "big": {
            "for_bright_background": {
                "orig": "/img2/orig/EDIT_BIG-8c209b52e431d534968681-2cd40bba.svg?t=1720244491"
            },
            "for_dark_background": {
                "orig": "/img2/orig/EDIT_BIG.D-8c209b52e431d534968681-4127d696.svg?t=1720244491"
            }
        }
    }
}
Note that depending on your subscription plan and on the company you are looking for, the logo might not be available in all sizes or formats. When the logo is not available in a specific size or format, the field specific will be missing from the JSON response.

Root Level Properties

Field Type Description
name string The name of the company
symbol string The stock market symbol/ticker of the company
country string The country where the company is based
website_domain string|null The company's website domain, if available
last_update number Unix timestamp of when the data was last updated
png object Contains PNG image variations
svg object Contains SVG image variations

JSON Image Structure

PNG Images (png)

The png object contains two main categories:

Icon Images (icon)

Contains smaller-sized images typically the company's symbol or icon with two background variants, one for dark backgrounds (dark mode) and one for bright backgrounds (light mode):

Big Images (big)

Contains larger-sized images with two background variants:

SVG Images (svg)

The svg object follows the same categorical structure but only includes original versions:

Icon Images (icon)

Big Images (big)