This API returns historical Environmental, Social, Governance and Overall scores for companies on a scale of 0 to 100 based on the year provided in the request. In addition to this, the API also provides other relevant metrics like Global Rank, Industry Rank and more.

Please Note: GaiaLens tracks over 17,000 companies, however only the top 2,000 companies by market capitalization are available via this API. In case you need more please visit https://www.gaia-lens.com/

Arguments: The user must provide the year for which the historical scores are required. In addition to the year, there are three other arguments that the user can provide: companyname, isin, sedol. The user must provide exactly one of these three arguments. The API will return an error response if more than one of these three or no arguments are provided.

• companyname (optional): The name of the company. e.g. ‘Apple Inc.’. This must be an exact match. We provide a companynames API (click here) that can be used to retrieve all the company names available.

• isin (optional): The International Securities Identification Number (ISIN) for the company. e.g. ‘US0378331005’

• sedol (optional): The stock exchange daily official list (SEDOL) for the company. e.g. ‘2046251’

• year (required): The year for which the scores are being requested. In case there are no scores for the provided year a response code ‘204’ will be returned

Header: The header must contain the below two parameters:

• X-RapidAPI-Host: This must be set to ‘gaialens-historical-esg-scores.p.rapidapi.com’

• X-RapidAPI-Key: This must contain the Rapid API key for the user

Sample python request code:

import requests

url = "https://gaialens-historical-esg-scores.p.rapidapi.com/scores/historical/2020"

querystring = {"companyname":"Apple Inc."}

headers = {
	"X-RapidAPI-Host": "gaialens-historical-esg-scores.p.rapidapi.com",
	"X-RapidAPI-Key": ""
}

response = requests.request("GET", url, headers=headers, params=querystring)

print(response.text)

Sample response:

[
    {
        "request_id": 30792,
        "companyname": "Apple Inc.",
        "industry": "Technology Hardware, Storage and Peripherals",
        "country": "United States",
        "exchangename": "Nasdaq Global Select",
        "tickersymbol": "AAPL",
        "Year": 2020,
        "Overall Score": 43.906848038,
        "Overall Transparency Score": 88.9033438615,
        "Environmental Pillar Score": 81.6704081981,
        "Social Pillar Score": 31.5533899344,
        "Governance Pillar Score": 53.1902682431,
        "Overall Score Global Rank": "7060/17154",
        "Overall Industry Rank": "58/151",
        "Overall Region Rank": "1699/3509",
        "Latest Score Date": "15 May 2022"
    }
]