Indicators Historical Data

The historical endpoint contains a time series with fields such as country, category, datetime, close, frequency, historicalDataSymbol, lastupdate, and observed value. It allows one to check the evolution of key indicators over time.

By country and indicator

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/historical/country/mexico/indicator/gdp?c={your_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 your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/country/mexico/indicator/gdp?c=${your_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=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);
        }
    }
}

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=your_api_key");

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

https://api.tradingeconomics.com/historical/country/{country}/indicator/{indicator}?c={your_api_key}&f=json

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

https://api.tradingeconomics.com/historical/country/{country}/indicator/{indicator}?c={your_api_key}&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

https://api.tradingeconomics.com/historical/country/{country}/indicator/{indicator}?c={your_api_key}&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>

https://api.tradingeconomics.com/historical/country/{country}/indicator/{indicator}?c={your_api_key}
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

By country, indicator and date

Using Requests:

import requests
your_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={your_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 your_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=${your_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=your_api_key");

https://api.tradingeconomics.com/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}&f=json

[
  {
    "Country": "Mexico",
    "Category": "GDP",
    "DateTime": "2022-12-31T00:00:00",
    "Value": 1414.19,
    "Frequency": "Yearly",
    "HistoricalDataSymbol": "WGDPMEXI",
    "LastUpdate": "2023-06-30T15:54:00"
  },
  {
    "Country": "Mexico",
    "Category": "Population",
    "DateTime": "2022-12-31T00:00:00",
    "Value": 129.0,
    "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.94,
    "Frequency": "Yearly",
    "HistoricalDataSymbol": "WGDPSWED",
    "LastUpdate": "2023-06-30T15:55:00"
  }
]

https://api.tradingeconomics.com/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}&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

https://api.tradingeconomics.com/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}&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>Latest updates

https://api.tradingeconomics.com/historical/country/{countries}/indicator/{indicators}/{yyyy-mm-dd}/{yyyy-mm-dd}?c={your_api_key}
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

By ticker

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c={your_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 your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/ticker/USURTOT/2015-03-01?c=${your_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=your_api_key");

https://api.tradingeconomics.com/historical/ticker/{ticker}/{yyyy-mm-dd}?c={your_api_key}&f=json

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

https://api.tradingeconomics.com/historical/ticker/{ticker}/{yyyy-mm-dd}?c={your_api_key}&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

https://api.tradingeconomics.com/historical/ticker/{ticker}/{yyyy-mm-dd}?c={your_api_key}&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>

https://api.tradingeconomics.com/historical/ticker/{ticker}/{yyyy-mm-dd}?c={your_api_key}
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

Note: Ticker symbols can be retrieved using the Snapshot or Search endpoints.

Latest historical

Historical endpoint that provides a response containing all recently updated/revised economic indicator records.

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/historical/latest?c={your_api_key}&country=brazil&date=2025-08-26'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalLatest(country=['United States', 'Brazil'], date='2025-08-26')

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/latest?c=${your_api_key}&country=brazil&date=2025-08-26`)
    console.log(response.data)
})()

Or using our package:

data = te.getHistoricalLatest(country=['United States', 'Brazil'], date='2025-08-26').then(function(data){
  console.log(data)       
});

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/latest?c=your_api_key&country=brazil&date=2025-08-26");

https://api.tradingeconomics.com/historical/latest?c={your_api_key}&f=json

[
  {
    "Country": "Greece",
    "Category": "Car Registrations",
    "DateTime": "2025-02-28T00:00:00",
    "Value": 9818.0,
    "Frequency": "Monthly",
    "HistoricalDataSymbol": "GREECECARREG",
    "LastUpdate": "2025-03-13T14:49:00"
  },
  {
    "Country": "Italy",
    "Category": "Part Time Employment",
    "DateTime": "2024-12-31T00:00:00",
    "Value": 3296.0,
    "Frequency": "Quarterly",
    "HistoricalDataSymbol": "ITALYPARTIMEMP",
    "LastUpdate": "2025-03-13T14:47:00"
  },
  {
    "Country": "Italy",
    "Category": "Full Time Employment",
    "DateTime": "2024-12-31T00:00:00",
    "Value": 15666.0,
    "Frequency": "Quarterly",
    "HistoricalDataSymbol": "ITALYFULTIMEMP",
    "LastUpdate": "2025-03-13T14:46:00"
  }
]

https://api.tradingeconomics.com/historical/latest?c={your_api_key}&f=csv

Country	Category	DateTime	Close	Frequency	HistoricalDataSymbol	LastUpdate
Greece	Car Registrations	2/28/2025 12:00:00 AM	9818.0000	Monthly	GREECECARREG	3/13/2025 2:49:00 PM
Italy	Part Time Employment	12/31/2024 12:00:00 AM	3296.0000	Quarterly	ITALYPARTIMEMP	3/13/2025 2:47:00 PM
Italy	Full Time Employment	12/31/2024 12:00:00 AM	15666.0000	Quarterly	ITALYFULTIMEMP	3/13/2025 2:46:00 PM

https://api.tradingeconomics.com/historical/latest?c={your_api_key}&f=xml

<ArrayOfHistoricalIndicator xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<HistoricalIndicator>
<Category>Car Registrations</Category>
<Country>Greece</Country>
<DateTime>2025-02-28T00:00:00</DateTime>
<Frequency>Monthly</Frequency>
<HistoricalDataSymbol>GREECECARREG</HistoricalDataSymbol>
<LastUpdate>2025-03-13T14:49:00</LastUpdate>
<Value>9818.0000</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>Part Time Employment</Category>
<Country>Italy</Country>
<DateTime>2024-12-31T00:00:00</DateTime>
<Frequency>Quarterly</Frequency>
<HistoricalDataSymbol>ITALYPARTIMEMP</HistoricalDataSymbol>
<LastUpdate>2025-03-13T14:47:00</LastUpdate>
<Value>3296.0000</Value>
</HistoricalIndicator>
<HistoricalIndicator>
<Category>Full Time Employment</Category>
<Country>Italy</Country>
<DateTime>2024-12-31T00:00:00</DateTime>
<Frequency>Quarterly</Frequency>
<HistoricalDataSymbol>ITALYFULTIMEMP</HistoricalDataSymbol>
<LastUpdate>2025-03-13T14:46:00</LastUpdate>
<Value>15666.0000</Value>
</HistoricalIndicator>
</ArrayOfHistoricalIndicator>

https://api.tradingeconomics.com/historical/latest?c={your_api_key}
CountryCategoryDateTimeCloseFrequencyHistoricalDataSymbolLastUpdate
GreeceCar Registrations2/28/2025 12:00:00 AM9818.0000MonthlyGREECECARREG3/13/2025 2:49:00 PM
ItalyPart Time Employment12/31/2024 12:00:00 AM3296.0000QuarterlyITALYPARTIMEMP3/13/2025 2:47:00 PM
ItalyFull Time Employment12/31/2024 12:00:00 AM15666.0000QuarterlyITALYFULTIMEMP3/13/2025 2:46:00 PM

Latest updates

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/historical/updates?c={your_api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getHistoricalUpdates()

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/updates?c=${your_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=your_api_key");

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&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"
  }
]

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&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

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&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>

https://api.tradingeconomics.com/historical/updates?c={your_api_key}
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

Latest updates by date

Filter historical updates by date range and/or last update date.

Using Requests:

import requests
your_api_key = 'your_api_key'
url = f'https://api.tradingeconomics.com/historical/updates?d1=2025-01-01&d2=2025-01-01&c={your_api_key}'
data = requests.get(url).json()
print(data)

By last update date:

url = f'https://api.tradingeconomics.com/historical/updates?lu=2025-01-01&c={your_api_key}'
data = requests.get(url).json()
print(data)

By date range and last update date:

url = f'https://api.tradingeconomics.com/historical/updates?d1=2025-01-01&d2=2025-01-01&lu=2025-01-01&c={your_api_key}'
data = requests.get(url).json()
print(data)

Using Requests:

const axios = require('axios');
(async () => {
    const your_api_key = 'your_api_key'
    const response = await axios.get(`https://api.tradingeconomics.com/historical/updates?d1=2025-01-01&d2=2025-01-01&c=${your_api_key}`)
    console.log(response.data)
})()

By last update date:

const response = await axios.get(`https://api.tradingeconomics.com/historical/updates?lu=2025-01-01&c=${your_api_key}`)

By date range and last update date:

const response = await axios.get(`https://api.tradingeconomics.com/historical/updates?d1=2025-01-01&d2=2025-01-01&lu=2025-01-01&c=${your_api_key}`)

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/updates?d1=2025-01-01&d2=2025-01-01&c=your_api_key");

By last update date:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/updates?lu=2025-01-01&c=your_api_key");

By date range and last update date:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/historical/updates?d1=2025-01-01&d2=2025-01-01&lu=2025-01-01&c=your_api_key");

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&d1={yyyy-mm-dd}&d2={yyyy-mm-dd}&f=json

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

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&d1={yyyy-mm-dd}&d2={yyyy-mm-dd}&f=csv

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

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&d1={yyyy-mm-dd}&d2={yyyy-mm-dd}&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>2025-01-01T16:39:00</LastUpdate>
</UpdatedItem>
<UpdatedItem>
<Category>Inflation Rate</Category>
<Country>Tanzania</Country>
<HistoricalDataSymbol>TANZANIAIR</HistoricalDataSymbol>
<LastUpdate>2025-01-01T16:28:00</LastUpdate>
</UpdatedItem>
<UpdatedItem>
<Category>Deposit Interest Rate</Category>
<Country>Uganda</Country>
<HistoricalDataSymbol>UGAFRINRDPST</HistoricalDataSymbol>
<LastUpdate>2025-01-01T16:06:00</LastUpdate>
</UpdatedItem>
</ArrayOfUpdatedItem>

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&d1={yyyy-mm-dd}&d2={yyyy-mm-dd}

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&lu={yyyy-mm-dd}

https://api.tradingeconomics.com/historical/updates?c={your_api_key}&d1={yyyy-mm-dd}&d2={yyyy-mm-dd}&lu={yyyy-mm-dd}
CountryCategoryHistoricalDataSymbolLastUpdate
AustriaCapital FlowsAUSTRIACAPFLO1/1/2025 4:39:00 PM
TanzaniaInflation RateTANZANIAIR1/1/2025 4:28:00 PM
UgandaDeposit Interest RateUGAFRINRDPST1/1/2025 4:06:00 PM

Response fields

FieldTypeDescriptionExample
CountrystringName of the country associated with the indicator.“Mexico”
CategorystringEconomic indicator name or category.“GDP”
Date TimestringDate of the reported value, in UTC format.“2021-12-31T00:00:00”
ClosenumberValue of the indicator at the specified date.*1272.8400
FrequencystringFrequency of the data series.“Yearly”
HistoricalDataSymbolstringUnique identifier used internally by Trading Economics to represent the series.“WGDPMEXI”
LastUpdatestringTimestamp of the most recent update to the data (insert or change), in UTC.“2022-12-30T12:46:00”

Fields in ‘Latest updates’

FieldTypeDescriptionExample
CountrystringName of the country associated with the indicator.“Mexico”
CategorystringEconomic indicator name or category.“GDP”
HistoricalDataSymbolstringUnique identifier used internally by Trading Economics to represent the series.“WGDPMEXI”
LastUpdatestringTimestamp of the most recent update to the data (insert or change), in UTC.“2022-12-30T12:46:00”

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