Welcome to the Xtract API documentation!
Our API is meticulously crafted to provide you with an efficient and streamlined way to access comprehensive summaries of Environmental, Social, and Governance (ESG) themes published by companies. With our robust API, you can effortlessly retrieve data on company profiles and gain insights into their ESG performance through concise summaries of their annual and sustainability reports.
In this all-inclusive documentation, you'll discover in-depth information on how to authenticate with the API, navigate the available endpoints, and practical examples that demonstrate the optimal utilization of our Xtract API. Embark on your journey to explore the ESG landscape with our cutting-edge solution at your fingertips.
To begin your journey, you will require an API key. To obtain one, please contact our dedicated team to learn more about API Plans. .
Once you have secured an API key, include it in the Authorization header of your requests to authenticate with the API.The Xtract API is designed to prioritize simplicity and ease of use. Our solution offers a straightforward approach to accessing invaluable company information and report summaries. Our database is constantly updated to ensure you have access to the most recent information available.
The Get Companies endpoint retrieves a comprehensive list of companies available in our database.
The information includes the company name, country, country code, International Securities Identification Number (ISIN), and symbol. This endpoint provides you with an extensive selection of companies, for which you can obtain ESG-related summaries.
The result is returned as a JSON array, allowing seamless integration into your application for further processing or display.
The Get Themes endpoint returns a curated list of ESG themes available in the API, along with a description of each theme.
Each theme represents a specific aspect of environmental, social, and governance considerations that companies are expected to address in their annual and sustainability reports.
The result is returned as a JSON array, which developers can use to filter and categorize ESG data obtained through other endpoints in the API.
The Get Summary endpoint is designed to retrieve ESG-related summaries for a specified company symbol and country code.
The results can be further refined by providing optional query parameters such as year, document type (Annual Report or Sustainability Report), and ESG theme.
The response is returned as a JSON object, making it convenient for developers to integrate the data into their applications.
‘symbol’ (required): The symbol of the company for which to retrieve the summary data. This can be found in the get-companies endpoint. Example: ‘AAPL’.
‘country_code’ (required): The country code of the company for which to retrieve the summary data. This can be found in the get-companies endpoint. Example: ‘US’.
‘year’ (optional): The year of the document for which to retrieve the summary data. If not specified, the API will return the summary for the most recent year available. Example: ‘2021’.
‘doc_type’ (optional): The type of document to filter the results by. Valid options are "AR" for Annual Report and "SR" for Sustainability Report. If not specified, the API will return the best document for the selected theme. Example: ‘AR’.
‘theme’ (optional): The ESG theme to filter the results by. This can be found in the get-themes endpoint. If not specified, the API will return data for all available themes. Example: ‘Gender equality’.
Note that the ‘symbol’ and ‘country_code’ parameters are required, while the others are optional.
You can use these query parameters to fine-tune the data returned by the API and retrieve only the information that you need.