Skip to content

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}, nameid being c_ and the company's number. There is no place.
  • indexes: {name, nameid, short_name}, nameid being in_ and a number. There is no place, region or score.
  • sources: {name, nameid}, name being the source's domain and nameid o_ and a number. There is no category.
  • commodity_list: {name, nameid, class, type}, nameid being cm_ and a number and class the commodity's symbol, for active commodities only. There is no subtype.

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.