Historical

By country and indicator

Using Requests:

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

Or using our package:

import tradingeconomics as te
te.login('your_api_key')
te.getHistoricalData(country='mexico', indicator='gdp')

With multi countries and indicators:

te.getHistoricalData(country=['mexico', 'sweden'], indicator=['gdp','population'], 
 initDate='2015-01-01')

Using Requests:

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

Or using our package:

const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getHistoricalData(country = 'mexico', indicator = 'gdp').then(function(data){
  console.log(data)       
});

With multi countries and indicators:

data = te.getHistoricalData(country = ['mexico','sweden'], indicator = ['gdp','population'], 
 start_date = '2015-01-01').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/historical/country/mexico/indicator/gdp?c=guest:guest"))
    {
        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);
        }
    }
}

With multi countries and indicators:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/country/mexico,sweden/indicator/gdp,population/2015-01-01?c=guest:guest");

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

/historical/country/{country}/indicator/{indicator}

CountryCategoryDateTimeCloseFrequencyHistoricalDataSymbolLastUpdate
MexicoGDP12/31/2022 12:00:00 AM1414.1900YearlyWGDPMEXI6/30/2023 3:54:00 PM
MexicoPopulation12/31/2022 12:00:00 AM129.0000YearlyMEX SP.POP.TOTL5/30/2023 6:48:00 PM
SwedenGDP12/31/2022 12:00:00 AM585.9400YearlyWGDPSWED6/30/2023 3:55:00 PM

/historical/country/{country}/indicator/{indicator}?f=json

[{"Country":"Mexico","Category":"GDP","DateTime":"2020-12-31T00:00:00","Value":1090.5100,"Frequency":"Yearly","HistoricalDataSymbol":"WGDPMEXI","LastUpdate":"2023-06-30T15:54:00"},{"Country":"Mexico","Category":"GDP","DateTime":"2021-12-31T00:00:00","Value":1272.8400,"Frequency":"Yearly","HistoricalDataSymbol":"WGDPMEXI","LastUpdate":"2022-12-30T12:46:00"},{"Country":"Mexico","Category":"GDP","DateTime":"2022-12-31T00:00:00","Value":1414.1900,"Frequency":"Yearly","HistoricalDataSymbol":"WGDPMEXI","LastUpdate":"2023-06-30T15:54:00"}]

/historical/country/{country}/indicator/{indicator}?f=csv

Country,Category,DateTime,Close,Frequency,HistoricalDataSymbol,LastUpdate
Mexico,GDP,12/31/2020 12:00:00 AM,1090.5100,Yearly,WGDPMEXI,6/30/2023 3:54:00 PM
Mexico,GDP,12/31/2021 12:00:00 AM,1272.8400,Yearly,WGDPMEXI,12/30/2022 12:46:00 PM
Mexico,GDP,12/31/2022 12:00:00 AM,1414.1900,Yearly,WGDPMEXI,6/30/2023 3:54:00 PM

/historical/country/{country}/indicator/{indicator}?f=xml

<ArrayOfHistoricalIndicator xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<HistoricalIndicator>
<Category>GDP</Category>
<Country>Mexico</Country>
<DateTime>2020-12-31T00:00:00</DateTime>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPMEXI</HistoricalDataSymbol>
<LastUpdate>2023-06-30T15:54:00</LastUpdate>
<Value>1090.5100</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>GDP</Category>
<Country>Mexico</Country>
<DateTime>2021-12-31T00:00:00</DateTime>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPMEXI</HistoricalDataSymbol>
<LastUpdate>2022-12-30T12:46:00</LastUpdate>
<Value>1272.8400</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>GDP</Category>
<Country>Mexico</Country>
<DateTime>2022-12-31T00:00:00</DateTime>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPMEXI</HistoricalDataSymbol>
<LastUpdate>2023-06-30T15:54:00</LastUpdate>
<Value>1414.1900</Value>
</HistoricalIndicator>
</ArrayOfHistoricalIndicator>

By country, indicator and date

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/historical/country/mexico,sweden/indicator/gdp,population/2015-01-01/2015-12-31?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalData(country=['mexico', 'sweden'], indicator=['gdp','population'], 
 initDate='2015-01-01', endDate='2015-12-31')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/country/mexico,sweden/indicator/gdp,population/2015-01-01/2015-12-31?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getHistoricalData(country = ['mexico','sweden'], indicator = ['gdp','population'], 
 start_date = '2015-01-01', end_date = '2015-12-31').then(function(data){
  console.log(data)
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/country/mexico,sweden/indicator/gdp,population/2015-01-01/2015-12-31?c=guest:guest");

/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}

CountryCategoryDateTimeCloseFrequencyHistoricalDataSymbolLastUpdate
MexicoGDP12/31/2022 12:00:00 AM1414.1900YearlyWGDPMEXI6/30/2023 3:54:00 PM
MexicoPopulation12/31/2022 12:00:00 AM129.0000YearlyMEX SP.POP.TOTL5/30/2023 6:48:00 PM
SwedenGDP12/31/2022 12:00:00 AM585.9400YearlyWGDPSWED6/30/2023 3:55:00 PM

/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=json

[{"Country":"Mexico","Category":"GDP","DateTime":"2022-12-31T00:00:00","Value":1414.1900,"Frequency":"Yearly","HistoricalDataSymbol":"WGDPMEXI","LastUpdate":"2023-06-30T15:54:00"},{"Country":"Mexico","Category":"Population","DateTime":"2022-12-31T00:00:00","Value":129.0000,"Frequency":"Yearly","HistoricalDataSymbol":"MEX SP.POP.TOTL","LastUpdate":"2023-05-30T18:48:00"},{"Country":"Sweden","Category":"GDP","DateTime":"2022-12-31T00:00:00","Value":585.9400,"Frequency":"Yearly","HistoricalDataSymbol":"WGDPSWED","LastUpdate":"2023-06-30T15:55:00"}]

/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=csv

Country,Category,DateTime,Close,Frequency,HistoricalDataSymbol,LastUpdate
Mexico,GDP,12/31/2022 12:00:00 AM,1414.1900,Yearly,WGDPMEXI,6/30/2023 3:54:00 PM
Mexico,Population,12/31/2022 12:00:00 AM,129.0000,Yearly,MEX SP.POP.TOTL,5/30/2023 6:48:00 PM
Sweden,GDP,12/31/2022 12:00:00 AM,585.9400,Yearly,WGDPSWED,6/30/2023 3:55:00 PM

/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?f=xml

<ArrayOfHistoricalIndicator xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<HistoricalIndicator>
<Category>GDP</Category>
<Country>Mexico</Country>
<DateTime>2022-12-31T00:00:00</DateTime>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPMEXI</HistoricalDataSymbol>
<LastUpdate>2023-06-30T15:54:00</LastUpdate>
<Value>1414.1900</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>Population</Category>
<Country>Mexico</Country>
<DateTime>2022-12-31T00:00:00</DateTime>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>MEX SP.POP.TOTL</HistoricalDataSymbol>
<LastUpdate>2023-05-30T18:48:00</LastUpdate>
<Value>129.0000</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>GDP</Category>
<Country>Sweden</Country>
<DateTime>2022-12-31T00:00:00</DateTime>
<Frequency>Yearly</Frequency>
<HistoricalDataSymbol>WGDPSWED</HistoricalDataSymbol>
<LastUpdate>2023-06-30T15:55:00</LastUpdate>
<Value>585.9400</Value>
</HistoricalIndicator>
</ArrayOfHistoricalIndicator>

By ticker

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalByTicker(ticker = 'USURTOT', start_date = '2015-03-01')   

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getHistoricalData(ticker = 'usurtot', start_date = '2015-03-01' ).then(function(data){
  console.log(data)       
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c=guest:guest");

/historical/ticker/{ticker}/{yyyy-mm-dd}

CountryCategoryDateTimeCloseFrequencyHistoricalDataSymbolLastUpdate
United StatesUnemployment Rate4/30/2023 12:00:00 AM3.4000MonthlyUSURTOT6/2/2023 12:30:00 PM
United StatesUnemployment Rate5/31/2023 12:00:00 AM3.7000MonthlyUSURTOT7/7/2023 12:30:00 PM
United StatesUnemployment Rate6/30/2023 12:00:00 AM3.6000MonthlyUSURTOT7/7/2023 12:30:00 PM

/historical/ticker/{ticker}/{yyyy-mm-dd}?f=json

[{"Country":"United States","Category":"Unemployment Rate","DateTime":"2023-07-31T00:00:00","Value":3.5000,"Frequency":"Monthly","HistoricalDataSymbol":"USURTOT","LastUpdate":"2023-09-01T12:30:00"},{"Country":"United States","Category":"Unemployment Rate","DateTime":"2023-08-31T00:00:00","Value":3.8000,"Frequency":"Monthly","HistoricalDataSymbol":"USURTOT","LastUpdate":"2023-10-06T12:30:00"},{"Country":"United States","Category":"Unemployment Rate","DateTime":"2023-09-30T00:00:00","Value":3.8000,"Frequency":"Monthly","HistoricalDataSymbol":"USURTOT","LastUpdate":"2023-10-06T12:30:00"}]

/historical/ticker/{ticker}/{yyyy-mm-dd}?f=csv

Country,Category,DateTime,Close,Frequency,HistoricalDataSymbol,LastUpdate
United States,Unemployment Rate,7/31/2023 12:00:00 AM,3.5000,Monthly,USURTOT,9/1/2023 12:30:00 PM
United States,Unemployment Rate,8/31/2023 12:00:00 AM,3.8000,Monthly,USURTOT,10/6/2023 12:30:00 PM
United States,Unemployment Rate,9/30/2023 12:00:00 AM,3.8000,Monthly,USURTOT,10/6/2023 12:30:00 PM

/historical/ticker/{ticker}/{yyyy-mm-dd}?f=xml

<ArrayOfHistoricalIndicator xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<HistoricalIndicator>
<Category>Unemployment Rate</Category>
<Country>United States</Country>
<DateTime>2023-07-31T00:00:00</DateTime>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>USURTOT</HistoricalDataSymbol>
<LastUpdate>2023-09-01T12:30:00</LastUpdate>
<Value>3.5000</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>Unemployment Rate</Category>
<Country>United States</Country>
<DateTime>2023-08-31T00:00:00</DateTime>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>USURTOT</HistoricalDataSymbol>
<LastUpdate>2023-10-06T12:30:00</LastUpdate>
<Value>3.8000</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>Unemployment Rate</Category>
<Country>United States</Country>
<DateTime>2023-09-30T00:00:00</DateTime>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>USURTOT</HistoricalDataSymbol>
<LastUpdate>2023-10-06T12:30:00</LastUpdate>
<Value>3.8000</Value>
</HistoricalIndicator>
</ArrayOfHistoricalIndicator>

Latest updates

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalUpdates()

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

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

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/updates?c=guest:guest");

/historical/updates

CountryCategoryHistoricalDataSymbolLastUpdate
United StatesConsumer CreditUNITEDSTACONCRE7/10/2023 7:01:00 PM
NicaraguaForeign Direct InvestmentNICARAGUAFORDIRINV7/10/2023 5:17:00 PM
Dominican RepublicExternal Debt to GDPDOMEDTG7/10/2023 4:29:00 PM

/historical/updates?f=json

[{"Country":"Austria","Category":"Capital Flows","HistoricalDataSymbol":"AUSTRIACAPFLO","LastUpdate":"2023-10-09T16:39:00"},{"Country":"Tanzania","Category":"Inflation Rate","HistoricalDataSymbol":"TANZANIAIR","LastUpdate":"2023-10-09T16:28:00"},{"Country":"Uganda","Category":"Deposit Interest Rate","HistoricalDataSymbol":"UGAFRINRDPST","LastUpdate":"2023-10-09T16:06:00"}]

/historical/updates?f=csv

Country,Category,HistoricalDataSymbol,LastUpdate
Austria,Capital Flows,AUSTRIACAPFLO,10/9/2023 4:39:00 PM
Tanzania,Inflation Rate,TANZANIAIR,10/9/2023 4:28:00 PM
Uganda,Deposit Interest Rate,UGAFRINRDPST,10/9/2023 4:06:00 PM

/historical/updates?f=xml

<ArrayOfUpdatedItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<UpdatedItem>
<Category>Capital Flows</Category>
<Country>Austria</Country>
<HistoricalDataSymbol>AUSTRIACAPFLO</HistoricalDataSymbol>
<LastUpdate>2023-10-09T16:39:00</LastUpdate>
</UpdatedItem>
<UpdatedItem>
<Category>Inflation Rate</Category>
<Country>Tanzania</Country>
<HistoricalDataSymbol>TANZANIAIR</HistoricalDataSymbol>
<LastUpdate>2023-10-09T16:28:00</LastUpdate>
</UpdatedItem>
<UpdatedItem>
<Category>Deposit Interest Rate</Category>
<Country>Uganda</Country>
<HistoricalDataSymbol>UGAFRINRDPST</HistoricalDataSymbol>
<LastUpdate>2023-10-09T16:06:00</LastUpdate>
</UpdatedItem>
</ArrayOfUpdatedItem>

Response fields

FieldTypeDescriptionExample
CountrystringCountry name“Mexico”
CategorystringIndicator category name“GDP”
Date TimestringRelease time and date in UTC“2021-12-31T00:00:00”
ClosenumberValue *1272.8400
FrequencystringFrequency of the indicator“Yearly”
HistoricalDataSymbolstringUnique symbol used by TradingEconomics“WGDPMEXI”
LastUpdatestringTime when new data was inserted or changed“2022-12-30T12:46:00”

Fields in ‘Latest updates’

FieldTypeDescriptionExample
CountrystringCountry name“Mexico”
CategorystringIndicator category name“GDP”
HistoricalDataSymbolstringUnique symbol used by TradingEconomics“WGDPMEXI”
LastUpdatestringTime when new data was inserted or changed“2022-12-30T12:46:00”

*Python package response field returns Value instead of ‘Close’.