Search
You can search by keyword, term, or category. If you do not know which category to look for, just use the search/{term} endpoint option.
Note: The response fields returned will depend on the search results
By term
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/search/gold?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
import tradingeconomics as te
te.login('your_api_key')
te.getSearch(term = 'gold')
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/search/gold?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
const te = require('tradingeconomics');
te.login('your_api_key');
data = te.getSearch(term = 'gold').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/search/gold?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.
Symbol | Category | Country | LatestValue | Frequency | Unit | Currency | Title | Url | Type | Importance | LastUpdate |
---|---|---|---|---|---|---|---|---|---|---|---|
CHINAGOLRES | Gold Reserves | China | 2068.36 | Quarterly | Tonnes | China Gold Reserves | /china/gold-reserves | Economic | 13 | May 5 2023 9:35PM | |
EUROAREAGOLRES | Gold Reserves | Euro Area | 506.52 | Quarterly | Tonnes | Euro Area Gold Reserves | /euro-area/gold-reserves | Economic | 13 | May 5 2023 9:35PM | |
GERMANYGOLRES | Gold Reserves | Germany | 3354.89 | Quarterly | Tonnes | Germany Gold Reserves | /germany/gold-reserves | Economic | 13 | May 5 2023 9:35PM |
[{"Symbol":"CHINAGOLRES"},{"Symbol":"EUROAREAGOLRES"},{"Symbol":"GERMANYGOLRES"},{"Symbol":"XAUUSD:CUR"}]
CHINAGOLRES,Gold Reserves,China,2113.46,Quarterly,Tonnes,,China Gold Reserves,/china/gold-reserves,Economic,13,Aug 7 2023 9:48AM
EUROAREAGOLRES,Gold Reserves,Euro Area,506.52,Quarterly,Tonnes,,Euro Area Gold Reserves,/euro-area/gold-reserves,Economic,13,Aug 14 2023 11:21AM
GERMANYGOLRES,Gold Reserves,Germany,3352.65,Quarterly,Tonnes,,Germany Gold Reserves,/germany/gold-reserves,Economic,13,Aug 8 2023 1:52AM
XAUUSD:CUR,commodity,commodity,1856.100000000000,Live,USD/t.oz, ,commodity commodity,/commodity/gold,markets,6,Oct 10 2023 1:50PM
List of categories
List all categories available for searching
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/search/categories?c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
te.getSearch()
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/search/categories?c=${api_key}`)
console.log(response.data)
})()
Or using our package:
data = te.getSearch().then(function(data){
console.log(data)
});
Using Requests:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/search/categories?c=your_api_key");
Categories |
---|
Markets |
Commodity |
Currency |
Index |
Economic |
Comtrade |
Worldbank - wb |
Federal Reserve - fred |
[{"Categories":"Markets"},{"Categories":"Commodity"},{"Categories":"Currency"},{"Categories":"Index"},{"Categories":"Economic"},{"Categories":"Comtrade"},{"Categories":"Worldbank - wb"},{"Categories":"Federal Reserve - fred"}]
Markets
Commodity
Currency
Index
By term and category
Using Requests:
import requests
api_key = 'YOUR_API_KEY'
url = f'https://api.tradingeconomics.com/search/japan?category=markets&c={api_key}'
data = requests.get(url).json()
print(data)
Or using our package:
te.getSearch(term = 'japan', category = 'markets')
Using Requests:
const axios = require('axios');
(async () => {
const api_key = 'YOUR_API_KEY'
const response = await axios.get(`https://api.tradingeconomics.com/search/japan?category=markets&c=${api_key}`)
console.log(response.data)
})()
Or using our package:
data = te.getSearch(term = 'japan', category = 'markets').then(function(data){
console.log(data)
});
Using Requests:
new HttpRequestMessage(new HttpMethod("GET"), "https://api.tradingeconomics.com/search/japan?category=markets&c=your_api_key");
/search/{term}?category={category}
Symbol | Ticker | Name | Country | Date | Type | decimals | state | Last | Close | CloseDate | MarketCap | URL | Importance | DailyChange | DailyPercentualChange | WeeklyChange | WeeklyPercentualChange | MonthlyChange | MonthlyPercentualChange | YearlyChange | YearlyPercentualChange | YTDChange | YTDPercentualChange | day_high | day_low | yesterday | lastWeek | lastMonth | lastYear | startYear | ISIN | unit | frequency | LastUpdate |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
GJGB10:IND | GJGB10 | Japan 10Y | Japan | 7/14/2023 12:20:13 PM | bond | /japan/government-bond-yield | Delayed | |||||||||||||||||||||||||||
GJGB1M:IND | GJGB1M | Japan 1M | Japan | 7/14/2023 12:00:00 AM | bond | /japan/1-month-bill-yield | Daily | |||||||||||||||||||||||||||
GJGB1Y:IND | GJGB1Y | Japan 52W | Japan | 7/14/2023 12:19:42 PM | bond | /japan/52-week-bill-yield | Delayed |
/search/{term}?category={category}?f=json
[{"Symbol":"GJGB10:IND","Ticker":"GJGB10","Name":"Japan 10Y","Country":"Japan","Date":"2023-10-10T13:59:37","Type":"bond","decimals":null,"state":null,"Last":null,"Close":null,"CloseDate":null,"MarketCap":null,"URL":"/japan/government-bond-yield","Importance":null,"DailyChange":null,"DailyPercentualChange":null,"WeeklyChange":null,"WeeklyPercentualChange":null,"MonthlyChange":null,"MonthlyPercentualChange":null,"YearlyChange":null,"YearlyPercentualChange":null,"YTDChange":null,"YTDPercentualChange":null,"day_high":null,"day_low":null}]
/search/{term}?category={category}?f=csv
GJGB10:IND,GJGB10,Japan 10Y,Japan,10/10/2023 1:59:37 PM,bond,,,,,,,/japan/government-bond-yield,,,,,,,,,,,,,,,,,,,,,Delayed,
GJGB1M:IND,GJGB1M,Japan 1M,Japan,10/10/2023 12:00:00 AM,bond,,,,,,,/japan/1-month-bill-yield,,,,,,,,,,,,,,,,,,,,,Daily,
GJGB1Y:IND,GJGB1Y,Japan 52W,Japan,10/10/2023 11:05:27 AM,bond,,,,,,,/japan/52-week-bill-yield,,,,,,,,,,,,,,,,,,,,,Delayed,
/search/{term}?category={category}?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.MarketSnapItem">
<d2p1:Close i:nil="true"/>
<d2p1:CloseDate i:nil="true"/>
<d2p1:Country>Japan</d2p1:Country>
<d2p1:DailyChange i:nil="true"/>
<d2p1:DailyPercentualChange i:nil="true"/>
<d2p1:Date>2023-10-10T13:59:37</d2p1:Date>
<d2p1:ISIN/>
<d2p1:Importance i:nil="true"/>
<d2p1:Last i:nil="true"/>
<d2p1:LastUpdate i:nil="true"/>
<d2p1:MarketCap i:nil="true"/>
<d2p1:MonthlyChange i:nil="true"/>
<d2p1:MonthlyPercentualChange i:nil="true"/>
<d2p1:Name>Japan 10Y</d2p1:Name>
<d2p1:Symbol>GJGB10:IND</d2p1:Symbol>
<d2p1:Ticker>GJGB10</d2p1:Ticker>
<d2p1:Type>bond</d2p1:Type>
<d2p1:URL>/japan/government-bond-yield</d2p1:URL>
<d2p1:WeeklyChange i:nil="true"/>
<d2p1:WeeklyPercentualChange i:nil="true"/>
<d2p1:YTDChange i:nil="true"/>
<d2p1:YTDPercentualChange i:nil="true"/>
<d2p1:YearlyChange i:nil="true"/>
<d2p1:YearlyPercentualChange i:nil="true"/>
<d2p1:day_high i:nil="true"/>
<d2p1:day_low i:nil="true"/>
<d2p1:decimals i:nil="true"/>
<d2p1:frequency>Delayed</d2p1:frequency>
<d2p1:lastMonth i:nil="true"/>
<d2p1:lastWeek i:nil="true"/>
<d2p1:lastYear i:nil="true"/>
<d2p1:startYear i:nil="true"/>
<d2p1:state i:nil="true"/>
<d2p1:unit i:nil="true"/>
<d2p1:yesterday i:nil="true"/>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.MarketSnapItem">
<d2p1:Close i:nil="true"/>
<d2p1:CloseDate i:nil="true"/>
<d2p1:Country>Japan</d2p1:Country>
<d2p1:DailyChange i:nil="true"/>
<d2p1:DailyPercentualChange i:nil="true"/>
<d2p1:Date>2023-10-10T00:00:00</d2p1:Date>
<d2p1:ISIN/>
<d2p1:Importance i:nil="true"/>
<d2p1:Last i:nil="true"/>
<d2p1:LastUpdate i:nil="true"/>
<d2p1:MarketCap i:nil="true"/>
<d2p1:MonthlyChange i:nil="true"/>
<d2p1:MonthlyPercentualChange i:nil="true"/>
<d2p1:Name>Japan 1M</d2p1:Name>
<d2p1:Symbol>GJGB1M:IND</d2p1:Symbol>
<d2p1:Ticker>GJGB1M</d2p1:Ticker>
<d2p1:Type>bond</d2p1:Type>
<d2p1:URL>/japan/1-month-bill-yield</d2p1:URL>
<d2p1:WeeklyChange i:nil="true"/>
<d2p1:WeeklyPercentualChange i:nil="true"/>
<d2p1:YTDChange i:nil="true"/>
<d2p1:YTDPercentualChange i:nil="true"/>
<d2p1:YearlyChange i:nil="true"/>
<d2p1:YearlyPercentualChange i:nil="true"/>
<d2p1:day_high i:nil="true"/>
<d2p1:day_low i:nil="true"/>
<d2p1:decimals i:nil="true"/>
<d2p1:frequency>Daily</d2p1:frequency>
<d2p1:lastMonth i:nil="true"/>
<d2p1:lastWeek i:nil="true"/>
<d2p1:lastYear i:nil="true"/>
<d2p1:startYear i:nil="true"/>
<d2p1:state i:nil="true"/>
<d2p1:unit i:nil="true"/>
<d2p1:yesterday i:nil="true"/>
</anyType>
<anyType xmlns:d2p1="http://schemas.datacontract.org/2004/07/APILib.DB" i:type="d2p1:Markets.MarketSnapItem">
<d2p1:Close i:nil="true"/>
<d2p1:CloseDate i:nil="true"/>
<d2p1:Country>Japan</d2p1:Country>
<d2p1:DailyChange i:nil="true"/>
<d2p1:DailyPercentualChange i:nil="true"/>
<d2p1:Date>2023-10-10T11:05:27</d2p1:Date>
<d2p1:ISIN/>
<d2p1:Importance i:nil="true"/>
<d2p1:Last i:nil="true"/>
<d2p1:LastUpdate i:nil="true"/>
<d2p1:MarketCap i:nil="true"/>
<d2p1:MonthlyChange i:nil="true"/>
<d2p1:MonthlyPercentualChange i:nil="true"/>
<d2p1:Name>Japan 52W</d2p1:Name>
<d2p1:Symbol>GJGB1Y:IND</d2p1:Symbol>
<d2p1:Ticker>GJGB1Y</d2p1:Ticker>
<d2p1:Type>bond</d2p1:Type>
<d2p1:URL>/japan/52-week-bill-yield</d2p1:URL>
<d2p1:WeeklyChange i:nil="true"/>
<d2p1:WeeklyPercentualChange i:nil="true"/>
<d2p1:YTDChange i:nil="true"/>
<d2p1:YTDPercentualChange i:nil="true"/>
<d2p1:YearlyChange i:nil="true"/>
<d2p1:YearlyPercentualChange i:nil="true"/>
<d2p1:day_high i:nil="true"/>
<d2p1:day_low i:nil="true"/>
<d2p1:decimals i:nil="true"/>
<d2p1:frequency>Delayed</d2p1:frequency>
<d2p1:lastMonth i:nil="true"/>
<d2p1:lastWeek i:nil="true"/>
<d2p1:lastYear i:nil="true"/>
<d2p1:startYear i:nil="true"/>
<d2p1:state i:nil="true"/>
<d2p1:unit i:nil="true"/>
<d2p1:yesterday i:nil="true"/>
</anyType>
</ArrayOfanyType>