News Category API
getNewsCategoriesThe getNewsCategories API provides access to news source category and sub-category data. Sources include Associated Press, Canadian Press, and Dow Jones
View All APIsContact Us to Get Access
Inputs
sourcesoptional
An id or code that identifies a news source. Multiple sources separated by a comma may be used.
Type
list (A comma or semi-colon delimited string.)
Example
AP,CMTX,USDAdepthoptional
An integer that will limit how many levels of the category tree to show. By default all levels are returned.
Type
int (A numeric type defining a whole number. (example: 2))
Example
2Outputs
category
always returned
always returned
The category symbol.
string
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
subcategories
as requested
as requested
The sub-categories.
array
A data structure that contains a group of elements.
A data structure that contains a group of elements.
Status Code Responses
200
OK
Success
400
Bad Request
The request was invalid, please see the message for more information.
500
Internal Server Error
Something is not working correctly, please contact support.
JSON
GET
GET https://ondemand.websol.barchart.com/getNewsCategories.json?apikey=YOUR_API_KEY&sources=AP%2CCMTX%2CUSDA&depth=2
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getNewsCategories.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&sources=AP%2CCMTX%2CUSDA&depth=2
Response
{
"status": {
"code": 200,
"message": "Success."
},
"results": [
{
"category": {
"name": "Economics",
"symbol": "ECO",
"subcategories": [
{
"category": {
"name": "Global Trade",
"symbol": "TRD"
}
},
{
"category": {
"name": "Employment",
"symbol": "EMP"
}
},
{
"category": {
"name": "Central Banks",
"symbol": "CBANK"
}
}
]
}
},
{
"category": {
"name": "Politics",
"symbol": "POL",
"subcategories": [
{
"category": {
"name": "Taxes",
"symbol": "TAX"
}
},
{
"category": {
"name": "Law",
"symbol": "LAW"
}
},
{
"category": {
"name": "Elections",
"symbol": "ELC"
}
}
]
}
},
{
"category": {
"name": "Geography",
"symbol": "GEO",
"subcategories": [
{
"category": {
"name": "United Kingdom",
"symbol": "UK"
}
},
{
"category": {
"name": "United States",
"symbol": "US"
}
},
{
"category": {
"name": "Canada",
"symbol": "CAN"
}
},
{
"category": {
"name": "Europe",
"symbol": "EUR"
}
},
{
"category": {
"name": "Bolivia",
"symbol": "BOL"
}
},
{
"category": {
"name": "Australia",
"symbol": "AUS"
}
},
{
"category": {
"name": "Peru",
"symbol": "PRU"
}
},
{
"category": {
"name": "Japan",
"symbol": "JPN"
}
},
{
"category": {
"name": "Chile",
"symbol": "CHI"
}
},
{
"category": {
"name": "China",
"symbol": "CHN"
}
},
{
"category": {
"name": "Germany",
"symbol": "GRM"
}
},
{
"category": {
"name": "Mexico",
"symbol": "MEX"
}
},
{
"category": {
"name": "Argentina",
"symbol": "ARG"
}
},
{
"category": {
"name": "Cuba",
"symbol": "CUB"
}
},
{
"category": {
"name": "Brazil",
"symbol": "BZL"
}
},
{
"category": {
"name": "France",
"symbol": "FRA"
}
},
{
"category": {
"name": "S. Korea",
"symbol": "KOR"
}
},
{
"category": {
"name": "Spain",
"symbol": "ESP"
}
},
{
"category": {
"name": "Iraq",
"symbol": "IRQ"
}
},
{
"category": {
"name": "Russia",
"symbol": "RUS"
}
},
{
"category": {
"name": "Asia",
"symbol": "ASA"
}
},
{
"category": {
"name": "Singapore",
"symbol": "SING"
}
},
{
"category": {
"name": "S. Korea",
"symbol": "SKOR"
}
},
{
"category": {
"name": "New Zealand",
"symbol": "KIWI"
}
},
{
"category": {
"name": "Philippines",
"symbol": "PHIL"
}
}
]
}
},
{
"category": {
"name": "Commodities",
"symbol": "FUT",
"subcategories": [
{
"category": {
"name": "Agriculture",
"symbol": "AG"
}
},
{
"category": {
"name": "Interest Rates",
"symbol": "FIN"
}
},
{
"category": {
"name": "Metals",
"symbol": "MTL"
}
},
{
"category": {
"name": "Softs",
"symbol": "SFT"
}
},
{
"category": {
"name": "Fruits & Vegetables",
"symbol": "FVT"
}
},
{
"category": {
"name": "Weather",
"symbol": "WTH"
}
},
{
"category": {
"name": "Forex",
"symbol": "CUR"
}
},
{
"category": {
"name": "Top News",
"symbol": "TOP"
}
},
{
"category": {
"name": "Options on Futures",
"symbol": "OPT"
}
},
{
"category": {
"name": "En",
"symbol": "ENG"
}
},
{
"category": {
"name": "Futures Education",
"symbol": "EDU"
}
},
{
"category": {
"name": "Equity Index",
"symbol": "IND"
}
},
{
"category": {
"name": "Grain",
"symbol": "GRN"
}
},
{
"category": {
"name": "Futures Exchange",
"symbol": "EXCH"
}
},
{
"category": {
"name": "Lumber",
"symbol": "WOOD"
}
},
{
"category": {
"name": "Food & Beverage",
"symbol": "FOOD"
}
},
{
"category": {
"name": "Livestock",
"symbol": "MEATS"
}
},
{
"category": {
"name": "Cryptocurrencies",
"symbol": "CRYPTO"
}
}
]
}
},
{
"category": {
"name": "Companies",
"symbol": "STK",
"subcategories": [
{
"category": {
"name": "Employees",
"symbol": "EMP"
}
},
{
"category": {
"name": "Mergers & Acquisitions",
"symbol": "MNA"
}
},
{
"category": {
"name": "Industries",
"symbol": "IND"
}
},
{
"category": {
"name": "Regulatory",
"symbol": "REG"
}
},
{
"category": {
"name": "Stock Options",
"symbol": "OPT"
}
},
{
"category": {
"name": "Stock Trading",
"symbol": "TRD"
}
},
{
"category": {
"name": "Private Companies",
"symbol": "PVT"
}
},
{
"category": {
"name": "Corporate Events",
"symbol": "EVNT"
}
},
{
"category": {
"name": "Analyst Ratings",
"symbol": "ANLST"
}
},
{
"category": {
"name": "Electronic Traded Funds",
"symbol": "FIN"
}
}
]
}
},
{
"category": {
"name": "Government Debt",
"symbol": "dFUT",
"subcategories": [
{
"category": {
"name": "Government Debt",
"symbol": "FIN"
}
}
]
}
}
]
}XML
GET
GET https://ondemand.websol.barchart.com/getNewsCategories.xml?apikey=YOUR_API_KEY&sources=AP%2CCMTX%2CUSDA&depth=2
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getNewsCategories.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&sources=AP%2CCMTX%2CUSDA&depth=2
Response
<?xml version="1.0" encoding="utf-8"?>
<getNewsCategories>
<status>
<code>200</code>
<message>Success.</message>
</status>
<item>
<category>
<name>Economics</name>
<symbol>ECO</symbol>
<subcategories>
<category>
<name>Global Trade</name>
<symbol>TRD</symbol>
</category>
<category>
<name>Employment</name>
<symbol>EMP</symbol>
</category>
<category>
<name>Central Banks</name>
<symbol>CBANK</symbol>
</category>
</subcategories>
</category>
</item>
<item>
<category>
<name>Politics</name>
<symbol>POL</symbol>
<subcategories>
<category>
<name>Taxes</name>
<symbol>TAX</symbol>
</category>
<category>
<name>Law</name>
<symbol>LAW</symbol>
</category>
<category>
<name>Elections</name>
<symbol>ELC</symbol>
</category>
</subcategories>
</category>
</item>
<item>
<category>
<name>Geography</name>
<symbol>GEO</symbol>
<subcategories>
<category>
<name>United Kingdom</name>
<symbol>UK</symbol>
</category>
<category>
<name>United States</name>
<symbol>US</symbol>
</category>
<category>
<name>Canada</name>
<symbol>CAN</symbol>
</category>
<category>
<name>Europe</name>
<symbol>EUR</symbol>
</category>
<category>
<name>Bolivia</name>
<symbol>BOL</symbol>
</category>
<category>
<name>Australia</name>
<symbol>AUS</symbol>
</category>
<category>
<name>Peru</name>
<symbol>PRU</symbol>
</category>
<category>
<name>Japan</name>
<symbol>JPN</symbol>
</category>
<category>
<name>Chile</name>
<symbol>CHI</symbol>
</category>
<category>
<name>China</name>
<symbol>CHN</symbol>
</category>
<category>
<name>Germany</name>
<symbol>GRM</symbol>
</category>
<category>
<name>Mexico</name>
<symbol>MEX</symbol>
</category>
<category>
<name>Argentina</name>
<symbol>ARG</symbol>
</category>
<category>
<name>Cuba</name>
<symbol>CUB</symbol>
</category>
<category>
<name>Brazil</name>
<symbol>BZL</symbol>
</category>
<category>
<name>France</name>
<symbol>FRA</symbol>
</category>
<category>
<name>S. Korea</name>
<symbol>KOR</symbol>
</category>
<category>
<name>Spain</name>
<symbol>ESP</symbol>
</category>
<category>
<name>Iraq</name>
<symbol>IRQ</symbol>
</category>
<category>
<name>Russia</name>
<symbol>RUS</symbol>
</category>
<category>
<name>Asia</name>
<symbol>ASA</symbol>
</category>
<category>
<name>Singapore</name>
<symbol>SING</symbol>
</category>
<category>
<name>S. Korea</name>
<symbol>SKOR</symbol>
</category>
<category>
<name>New Zealand</name>
<symbol>KIWI</symbol>
</category>
<category>
<name>Philippines</name>
<symbol>PHIL</symbol>
</category>
</subcategories>
</category>
</item>
<item>
<category>
<name>Commodities</name>
<symbol>FUT</symbol>
<subcategories>
<category>
<name>Agriculture</name>
<symbol>AG</symbol>
</category>
<category>
<name>Interest Rates</name>
<symbol>FIN</symbol>
</category>
<category>
<name>Metals</name>
<symbol>MTL</symbol>
</category>
<category>
<name>Softs</name>
<symbol>SFT</symbol>
</category>
<category>
<name>Fruits & Vegetables</name>
<symbol>FVT</symbol>
</category>
<category>
<name>Weather</name>
<symbol>WTH</symbol>
</category>
<category>
<name>Forex</name>
<symbol>CUR</symbol>
</category>
<category>
<name>Top News</name>
<symbol>TOP</symbol>
</category>
<category>
<name>Options on Futures</name>
<symbol>OPT</symbol>
</category>
<category>
<name>En</name>
<symbol>ENG</symbol>
</category>
<category>
<name>Futures Education</name>
<symbol>EDU</symbol>
</category>
<category>
<name>Equity Index</name>
<symbol>IND</symbol>
</category>
<category>
<name>Grain</name>
<symbol>GRN</symbol>
</category>
<category>
<name>Futures Exchange</name>
<symbol>EXCH</symbol>
</category>
<category>
<name>Lumber</name>
<symbol>WOOD</symbol>
</category>
<category>
<name>Food & Beverage</name>
<symbol>FOOD</symbol>
</category>
<category>
<name>Livestock</name>
<symbol>MEATS</symbol>
</category>
<category>
<name>Cryptocurrencies</name>
<symbol>CRYPTO</symbol>
</category>
</subcategories>
</category>
</item>
<item>
<category>
<name>Companies</name>
<symbol>STK</symbol>
<subcategories>
<category>
<name>Employees</name>
<symbol>EMP</symbol>
</category>
<category>
<name>Mergers & Acquisitions</name>
<symbol>MNA</symbol>
</category>
<category>
<name>Industries</name>
<symbol>IND</symbol>
</category>
<category>
<name>Regulatory</name>
<symbol>REG</symbol>
</category>
<category>
<name>Stock Options</name>
<symbol>OPT</symbol>
</category>
<category>
<name>Stock Trading</name>
<symbol>TRD</symbol>
</category>
<category>
<name>Private Companies</name>
<symbol>PVT</symbol>
</category>
<category>
<name>Corporate Events</name>
<symbol>EVNT</symbol>
</category>
<category>
<name>Analyst Ratings</name>
<symbol>ANLST</symbol>
</category>
<category>
<name>Electronic Traded Funds</name>
<symbol>FIN</symbol>
</category>
</subcategories>
</category>
</item>
<item>
<category>
<name>Government Debt</name>
<symbol>dFUT</symbol>
<subcategories>
<category>
<name>Government Debt</name>
<symbol>FIN</symbol>
</category>
</subcategories>
</category>
</item>
</getNewsCategories>
CSV
GET
GET https://ondemand.websol.barchart.com/getNewsCategories.csv?apikey=YOUR_API_KEY&sources=AP%2CCMTX%2CUSDA&depth=2
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getNewsCategories.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&sources=AP%2CCMTX%2CUSDA&depth=2
Response
name,symbol,parent
"Government Debt","dFUT"
"Government Debt","FIN","dFUT"
"Companies","STK"
"Electronic Traded Funds","FIN","STK"
"Analyst Ratings","ANLST","STK"
"Corporate Events","EVNT","STK"
"Private Companies","PVT","STK"
"Stock Trading","TRD","STK"
"Stock Options","OPT","STK"
"Regulatory","REG","STK"
"Industries","IND","STK"
"Mergers & Acquisitions","MNA","STK"
"Employees","EMP","STK"
"Commodities","FUT"
"Cryptocurrencies","CRYPTO","FUT"
"Livestock","MEATS","FUT"
"Food & Beverage","FOOD","FUT"
"Lumber","WOOD","FUT"
"Futures Exchange","EXCH","FUT"
"Grain","GRN","FUT"PHP
<?php
$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');
$params = [
'apikey' => 'YOUR_API_KEY',
'sources' => 'AP,CMTX,USDA',
'depth' => '2',
];
$result = $ondemand->getNewsCategories($params);
var_dump($result);Classic ASP
Dim ondemand
Dim result
Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")
Set result = ondemand.getNewsCategories("YOUR_API_KEY", "AP,CMTX,USDA", "2")Perl
use SOAP::Lite;
use SOAP::WSDL;
my $ondemand = SOAP::Lite
-> service('https://ondemand.websol.barchart.com/service?wsdl');
my $result = $ondemand->getNewsCategories('YOUR_API_KEY', 'AP,CMTX,USDA', '2');
print $result;Python
from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')
result = ondemand.service.getNewsCategories('YOUR_API_KEY', 'AP,CMTX,USDA', '2')
print(result)Ruby
require 'savon'
ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')
response = ondemand.call(
:getNewsCategories,
message: {
apikey: 'YOUR_API_KEY',
sources: 'AP,CMTX,USDA',
depth: '2',
}
)
response.body