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