Economic Calendar Point-in-Time

Use point-in-time parameters (initDate and endDate) to obtain economic calendar events filtered by date in the API. The point-in-time parameters set the data period for your requests.

Calendar methods described below support string dates in different formats:

Date FormatExample
yyyy-MM-dd2018-01-01
yyyy-mm-dd HH:mm2016-12-03 23:59:59

Point in time

Using Requests:

import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest?c={api_key}'
data = requests.get(url).json()
print(data)

Or using our package:

te.getCalendarData(category='initial jobless claims', country='united states',
 initDate='2016-12-01', endDate='2017-02-25')

Using Requests:

const axios = require('axios');
(async () => {
    const api_key = 'YOUR_API_KEY'
    const response = await axios.get(`https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest?c=${api_key}`)
    console.log(response.data)
})()

Or using our package:

data = te.getCalendar(indicator = 'initial jobless claims', country = 'united states',
 start_date = '2016-12-01', end_date = '2017-02-25').then(function(data){
    console.log(data)

Using Requests:

new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/calendar/country/united%20states/indicator/initial%20jobless%20claims/2016-12-01/2017-02-25?c=guest:guest");

/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}

CalendarIdDateCountryCategoryEventReferenceReferenceDateSourceSourceURLActualPreviousForecastTEForecastURLDateSpanImportanceLastUpdateRevisedCurrencyUnitTickerSymbol
8721312/1/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsNov/2611/26/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov268K251K253K253.1K/united-states/jobless-claims0212/1/2016 1:30:00 PMKIJCUSAIJCUSA
8722912/8/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsDec/0312/3/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov258K268K258K263K/united-states/jobless-claims0212/8/2016 1:31:00 PMKIJCUSAIJCUSA
8724012/15/2016 1:30:00 PMUnited StatesInitial Jobless ClaimsInitial Jobless ClaimsDec/1012/10/2016 12:00:00 AMU.S. Department of Laborhttps://www.dol.gov254K258K255K256K/united-states/jobless-claims0212/15/2016 1:30:00 PMKIJCUSAIJCUSA

/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?f=json

[{"CalendarId":"87213","Date":"2016-12-01T13:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Nov/26","ReferenceDate":"2016-11-26T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"268K","Previous":"251K","Forecast":"253K","TEForecast":"253.1K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2016-12-01T13:30:00","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"},{"CalendarId":"87229","Date":"2016-12-08T13:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Dec/03","ReferenceDate":"2016-12-03T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"258K","Previous":"268K","Forecast":"258K","TEForecast":"263K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2016-12-08T13:31:00","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"},{"CalendarId":"87240","Date":"2016-12-15T13:30:00","Country":"United States","Category":"Initial Jobless Claims","Event":"Initial Jobless Claims","Reference":"Dec/10","ReferenceDate":"2016-12-10T00:00:00","Source":"U.S. Department of Labor","SourceURL":"http://www.dol.gov","Actual":"254K","Previous":"258K","Forecast":"255K","TEForecast":"256K","URL":"/united-states/jobless-claims","DateSpan":"0","Importance":2,"LastUpdate":"2016-12-15T13:30:00","Revised":"","Currency":"","Unit":"K","Ticker":"IJCUSA","Symbol":"IJCUSA"}]

/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?f=csv

CalendarId,Date,Country,Category,Event,Reference,ReferenceDate,Source,SourceURL,Actual,Previous,Forecast,TEForecast,URL,DateSpan,Importance,LastUpdate,Revised,Currency,Unit,Ticker,Symbol
87213,12/1/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Nov/26,11/26/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,268K,251K,253K,253.1K,/united-states/jobless-claims,0,2,12/1/2016 1:30:00 PM,,,K,IJCUSA,IJCUSA
87229,12/8/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Dec/03,12/3/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,258K,268K,258K,263K,/united-states/jobless-claims,0,2,12/8/2016 1:31:00 PM,,,K,IJCUSA,IJCUSA
87240,12/15/2016 1:30:00 PM,United States,Initial Jobless Claims,Initial Jobless Claims,Dec/10,12/10/2016 12:00:00 AM,U.S. Department of Labor,http://www.dol.gov,254K,258K,255K,256K,/united-states/jobless-claims,0,2,12/15/2016 1:30:00 PM,,,K,IJCUSA,IJCUSA

/calendar/country/{countries}/indicator/{indicators}/{initDate}/{endDate}?f=xml

<ArrayOfCalendarItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/API.Models">
<CalendarItem>
<CalendarId>87213</CalendarId>
<Date>2016-12-01T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Nov/26</Reference>
<ReferenceDate>2016-11-26T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>268K</Actual>
<Previous>251K</Previous>
<Forecast>253K</Forecast>
<TEForecast>253.1K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-01T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>87229</CalendarId>
<Date>2016-12-08T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Dec/03</Reference>
<ReferenceDate>2016-12-03T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>258K</Actual>
<Previous>268K</Previous>
<Forecast>258K</Forecast>
<TEForecast>263K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-08T13:31:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
<CalendarItem>
<CalendarId>87240</CalendarId>
<Date>2016-12-15T13:30:00</Date>
<Country>United States</Country>
<Category>Initial Jobless Claims</Category>
<Event>Initial Jobless Claims</Event>
<Reference>Dec/10</Reference>
<ReferenceDate>2016-12-10T00:00:00</ReferenceDate>
<Source>U.S. Department of Labor</Source>
<SourceURL>http://www.dol.gov</SourceURL>
<Actual>254K</Actual>
<Previous>258K</Previous>
<Forecast>255K</Forecast>
<TEForecast>256K</TEForecast>
<URL>/united-states/jobless-claims</URL>
<DateSpan>0</DateSpan>
<Importance>2</Importance>
<LastUpdate>2016-12-15T13:30:00</LastUpdate>
<Revised/>
<Currency/>
<Unit>K</Unit>
<Ticker>IJCUSA</Ticker>
<Symbol>IJCUSA</Symbol>
</CalendarItem>
</ArrayOfCalendarItem>