List Companies, Sector and Category

Companies list

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/financials/companies?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

import tradingeconomics as te
te.login('your_api_key')
te.getFinancialsData()

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/financials/companies?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getFinancialsData().then(function(data){
  console.log(data)     
});

Using Requests:

using (var httpClient = new HttpClient())
{
    using (var request = new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/financials/companies?c=your_api_key"))
    {
        request.Headers.TryAddWithoutValidation("Upgrade-Insecure-Requests", "1");
        var response = await httpClient.SendAsync(request);
        if (response.IsSuccessStatusCode)
        {
            var content = await response.Content.ReadAsStringAsync(); 
            Console.WriteLine(content);
        }
    }
}

The response data format can be configured by appending the &f= parameter to the URL request.

/financials/companies

SymbolNameCountry
ARCO:USArcos DoradosArgentina
BFR:USBbva Banco FrancesArgentina
GGAL:USGrupo Financiero GaliciaArgentina

/financials/companies?f=json

[{"Symbol":"ARCO:US","Name":"Arcos Dorados","Country":"Argentina"},{"Symbol":"BFR:US","Name":"Bbva Banco Argentina","Country":"Argentina"},{"Symbol":"PAM:US","Name":"Pampa Energia","Country":"Argentina"}]

/financials/companies?f=csv

ARCO:US,Arcos Dorados,Argentina
BFR:US,Bbva Banco Argentina,Argentina
PAM:US,Pampa Energia,Argentina

By country

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/financials/companies?country=united%20states&c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getFinancialsData(country = 'united states')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/financials/companies?country=united%20states&c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getFinancialsData(country = 'united states').then(function(data){
  console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/financials/companies?country=united%20states&c=your_api_key");

With multi countries (maximum of 5):

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/financials/companies?country=spain,germany&c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getFinancialsData(country = ['spain', 'germany'])

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/financials/companies?country=spain,germany&c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getFinancialsData(country = ['spain', 'germany'] ).then(function(data){
  console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/financials/companies?country=spain,germany&c=your_api_key");

/financials/companies?country={country}

SymbolNameCountry
360:AULife360United States
A:USAgilentUnited States
AA:USAlcoaUnited States

/financials/companies?country={country}?f=json

[{"Symbol":"360:AU","Name":"Life360","Country":"United States"},{"Symbol":"A:US","Name":"Agilent","Country":"United States"},{"Symbol":"AA:US","Name":"Alcoa","Country":"United States"}]

/financials/companies?country={country}?f=csv

360:AU,Life360,United States
A:US,Agilent,United States
AA:US,Alcoa,United States

Sector list

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/sectors?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getSectors()

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/sectors?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getSectors().then(function(data){
  console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/sectors?c=your_api_key");

/sectors

Sector
Communication Services
Communications
Consumer Discretionary

/sectors?f=json

[{"Sector":"Communication Services"},{"Sector":"Communications"},{"Sector":"Consumer Discretionary"},{"Sector":"Consumer Staples"},{"Sector":"Energy"},{"Sector":"Financials"},{"Sector":"Health Care"},{"Sector":"Industrials"},{"Sector":"Information Technology"},{"Sector":"Materials"},{"Sector":"Period End Date"},{"Sector":"Real Estate"},{"Sector":"Technology"},{"Sector":"Utilities"}]

/sectors?f=csv

Sector
Communication Services
Communications
Consumer Discretionary
Consumer Staples
Energy
Financials
Health Care
Industrials
Information Technology
Materials
Period End Date
Real Estate
Technology
Utilities

/sectors?f=xml

<ArrayOfSectorsItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<SectorsItem>
<Sector>Communication Services</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Communications</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Consumer Discretionary</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Consumer Staples</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Energy</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Financials</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Health Care</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Industrials</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Information Technology</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Materials</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Period End Date</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Real Estate</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Technology</Sector>
</SectorsItem>
<SectorsItem>
<Sector>Utilities</Sector>
</SectorsItem>
</ArrayOfSectorsItem>

Categories list

List all categories available

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/financials/categories?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getFinancialsCategoryList()

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/financials/categories?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getFinancialsCategoryList().then(function(data){
  console.log(data)     
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/financials/categories?c=your_api_key");

/financials/categories

CategoryName
ebitdaEBITDA
epsEPS Earnings Per Share
interest-incomeInterest Income

/financials/categories?f=json

[{"Category":"ebitda","Name":"EBITDA"},{"Category":"eps","Name":"EPS Earnings Per Share"},{"Category":"interest-income","Name":"Interest Income"}]

/financials/categories?f=csv

ebitda,EBITDA
eps,EPS Earnings Per Share
interest-income,Interest Income

/financials/categories?f=xml

<ArrayOfanyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialCategoryItem">
<d2p1:Category>ebitda</d2p1:Category>
<d2p1:Name>EBITDA</d2p1:Name>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialCategoryItem">
<d2p1:Category>eps</d2p1:Category>
<d2p1:Name>EPS Earnings Per Share</d2p1:Name>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.FinancialCategoryItem">
<d2p1:Category>interest-income</d2p1:Category>
<d2p1:Name>Interest Income</d2p1:Name>
</anyType>
</ArrayOfanyType>

Response fields

Fields in ‘Companies list’

FieldTypeDescriptionExample
SymbolstringUnique symbol used by Trading Economics“aapl:us:assets”
NamestringName of the company“Life360 Inc”
CountrystringCompany Country“United States”

Fields in ‘Sector list’

FieldTypeDescriptionExample
SectorstringSector name“Communication Services”

Fields in ‘Categories list’

FieldTypeDescriptionExample
CategorystringFinancials category“eps”
NamestringCategory full name“EPS Earnings Per Share”