5.5 - get_data¶
Request¶
| Method | URL |
|---|---|
| GET | idata/get_data |
Parameters¶
| Params | Type | Values |
|---|---|---|
| type | String | Required: the list to return. Valid values are: ● “company_list”: every company of the InfoTrie directory, ● “indexes” ● “sources”: the news sources ● “commodity_list”: the active commodities ● “company_list_all”, “source_categories”, “exchanges” and “places” are no longer served ● any other value is refused with a 400 that lists the four served |
| version | String | Accepted and ignored: the full list is always returned, and version in the response is null. |
| last_update | Number | values: ● 0 or more, 0 by default, echoed back as last_update● It filters nothing: the full list is always returned |
Response¶
| Status | Response |
|---|---|
| 200 | Data structure for the response will depend on the data type. Refer the table below for each data type |
Data Type & Response Data Structure¶
company_list¶
company_list_all¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
"version" : <version>,
"data" : [
{
"name" : <company name>
"nameid" : <company_id>
"ticker" : <company ticker>
"place" : <place name>
"exchange" : <exchange name>
},
{ … }
]
}
}
commodity_list¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
"version" : <version>,
"data" : [
{
"name" : <commodity name>
"nameid" : <cm_<commodity_id>
"class" : <commodity class Symbol>
"type" : <commodity class Type>
"subtype" : <commodity class SubType>
}, { … }
]
}
}
sources¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
{ "version" : <version>,
"data" : [
{ "name" : <source name>,
"nameid" : o_<source_id>,
"category" : <comma separated category id’s (ca_)>
}, {…}
]
}
}}
NOTES:
● Refer to the get_data source_categories for the supported categories source_categories
● Maximum support of 3 levels. Means “parent category”, “child category” and “child of child category”.
● The priority can be used to decide the order of listing
source_categories¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
{
"version" : <version>,
"data" : [
{
"name" : <category name>,
"name_id" : ca_<category id>,
"priority" : <number in 0 -10>
"children" : [
"name": ,
"priority" : ,
"children" : [ … ]
},
{…}
]
}
}
}
indexes¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
{
"version" : <version>,
"data" : [
{
"name : <index name>,
"nameid" : in_<index_id>,
"place_name" : <place_name>,
"placeid" : pl_<place_id>,
"regionid" : pl_<region_id>,
"region_name" : <region name>,
"scoreid" : sc_<score_id>
},
{…}
]
}
}
}
exchanges¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
{
"version" : <version>,
"data" : [
{
"name" : <exchange name>,
"name_id" : <exchange id>
},
{…}
]
}
}
}
places¶
{
"last_update" : <integer timestamp> // value ‘0’ will return current data
"data" : {
{
"version" : <version>,
"data" : [
{
"place" : <place name>,
"nameid" : pl_<place_id>
},
{…}
]
}
}
}
Note (checked against the API on 2026-11-11)¶
The samples above are the legacy shapes. Today the envelope's Result is {opSuccess, type, last_update, data: {version, data}}, with version null, and the rows, sorted by id, are:
company_list:{name, nameid, ticker, exchange},nameidbeingc_and the company's number. There is noplace.indexes:{name, nameid, short_name},nameidbeingin_and a number. There is no place, region or score.sources:{name, nameid},namebeing the source's domain andnameido_and a number. There is nocategory.commodity_list:{name, nameid, class, type},nameidbeingcm_and a number andclassthe commodity's symbol, for active commodities only. There is nosubtype.
The sections company_list_all, source_categories, exchanges and places describe lists that are no longer served. Every call takes an InfoTrie API key in the X-API-Key header; the legacy AppKey header is refused with a 401. Each operation is served at https://api.infotrie.com/api/idata/ followed by its name.