LSEG Data Library for Python

get_data

Sends a request to the LSEG Data Platform to retrieve the data specified in the news.top_news.hierarchy.Definition object.

Module

data.content.news.top_news.hierarchy

Syntax

get_data(session)

Parameters

Value Description Data type Optional Default value
session Session object. If it's not passed the default session will be used. Session object Yes None

Returned value

Top news hierarchy response

Usage

The following example demonstrates how to get the top news hierarchy for the current top news packages:

response = news.top_news.hierarchy.Definition(id=news.top_news.hierarchy.TopNewsId.CURRENT).get_data()

print(response.data.df.to_string())

This example produces the following output:

Response
                                                   revisionId        revisionDate                                                topNewsId
Category           Subcategory                                                                                                            
Main               Front Page                          812904 2023-04-20 09:34:44       urn:newsml:reuters.com:20020923:SPDOC_119827232002
                   Central Banks & Global Economy      206046 2023-04-20 09:12:39      urn:newsml:reuters.com:20080317:SPDOC_1727041720081
                   Sustainable Finance                  29273 2023-04-20 09:08:08      urn:newsml:reuters.com:20201006:SPDOC_1174320062020
                   World News                          318156 2023-04-20 09:35:06        urn:newsml:reuters.com:20020924:SPDOC_56045242002
                   Regulation & Compliance               3800 2023-04-20 08:55:49      urn:newsml:reuters.com:20220405:SPDOC_1562710052022
Breakingviews      Reuters Breakingviews                54015 2023-04-20 09:11:03      urn:newsml:reuters.com:20090126:SPDOC_1343432620091
Banking & Finance  Financial Services                  198333 2023-04-20 09:29:45        urn:newsml:reuters.com:20030212:SPDOC_88894122003
                   Investment Banking                  178503 2023-04-20 09:37:14        urn:newsml:reuters.com:20030324:SPDOC_46640242003
                   IFR                                  76631 2023-04-20 09:42:14       urn:newsml:reuters.com:20090214:SPDOC_714091420091
                   Digital Finance & Crypto              2668 2023-04-20 09:38:17      urn:newsml:reuters.com:20220405:SPDOC_1617850052022
Companies          U.S. Companies                      386553 2023-04-20 08:42:37        urn:newsml:reuters.com:20020924:SPDOC_55977242002
                   European Companies                  238025 2023-04-20 09:35:23        urn:newsml:reuters.com:20020924:SPDOC_55994242002
                   Asian Companies                     214863 2023-04-20 09:14:33        urn:newsml:reuters.com:20020924:SPDOC_56007242002
Markets            Global Markets                      111183 2023-04-20 09:37:44      urn:newsml:reuters.com:20171024:SPDOC_1420030242017
                   Foreign Exchange                    163445 2023-04-20 09:12:41       urn:newsml:reuters.com:20030127:SPDOC_101094272003
                   Fixed Income                        131630 2023-04-20 09:06:35        urn:newsml:reuters.com:20030127:SPDOC_99618272003
                   Emerging Markets                    142334 2023-04-20 09:07:08        urn:newsml:reuters.com:20030915:SPDOC_39030152003
                   IFR                                  76631 2023-04-20 09:42:14       urn:newsml:reuters.com:20090214:SPDOC_714091420091
Commodities        Commodities                         167004 2023-04-20 09:36:35        urn:newsml:reuters.com:20060119:SPDOC_28769192006
                   Energy                              170614 2023-04-20 09:16:17      urn:newsml:reuters.com:20110214:SPDOC_1568591420111
                   Metals                              116064 2023-04-20 09:21:39      urn:newsml:reuters.com:20110214:SPDOC_1568781420111
                   Agricultural Commodities            127135 2023-04-20 09:35:46      urn:newsml:reuters.com:20110214:SPDOC_1568921420111
                   Global Gas, Power & LNG              92261 2023-04-20 09:36:04      urn:newsml:reuters.com:20110214:SPDOC_1569211420111
Industries         Technology, Media & Telecoms        168523 2023-04-20 09:23:10       urn:newsml:reuters.com:20060725:SPDOC_304469252006
                   Heavy Industry & Transport            7080 2023-04-20 09:35:52      urn:newsml:reuters.com:20220405:SPDOC_1661500052022
                   Consumer & Retail                   210475 2023-04-20 09:29:36        urn:newsml:reuters.com:20030314:SPDOC_75442142003
                   Healthcare & Pharma                 143533 2023-04-20 09:38:46        urn:newsml:reuters.com:20030314:SPDOC_75426142003
Regional           Australia & New Zealand              63023 2023-04-20 08:50:17      urn:newsml:reuters.com:20150107:SPDOC_2847160072015
                   Japan & the Koreas                    6231 2023-04-20 09:39:10      urn:newsml:reuters.com:20220405:SPDOC_1629240052022
                   Greater China                         7514 2023-04-20 09:37:14      urn:newsml:reuters.com:20220405:SPDOC_1623890052022
                   Southeast Asia                        4308 2023-04-20 08:11:52      urn:newsml:reuters.com:20220405:SPDOC_1641950052022
                   India & South Asia                    6723 2023-04-20 08:12:52      urn:newsml:reuters.com:20220405:SPDOC_1636380052022
                   Middle East & Africa                 27671 2023-04-20 09:32:04      urn:newsml:reuters.com:20201006:SPDOC_1158250062020
                   Europe & Russia                      12506 2023-04-20 09:31:42      urn:newsml:reuters.com:20220405:SPDOC_1655540052022
                   United Kingdom                        6928 2023-04-20 09:38:26      urn:newsml:reuters.com:20220405:SPDOC_1648750052022
                   Latin America                        92882 2023-04-20 08:45:15      urn:newsml:reuters.com:20080903:SPDOC_1319880320081
                   United States                        52514 2023-04-20 09:03:22      urn:newsml:reuters.com:20201006:SPDOC_1164560062020
                   Canada                              100647 2023-04-20 09:15:41      urn:newsml:reuters.com:20081001:SPDOC_1321850120081
National Languages 日本語トップニュース                           33521 2023-04-20 06:00:16      urn:newsml:reuters.com:20090527:SPDOC_1323242720091
                   路透中文新闻                               57299 2023-04-20 09:04:38      urn:newsml:reuters.com:20100623:SPDOC_1331612320101
                   Deutschland                          94817 2023-04-20 09:14:41       urn:newsml:reuters.com:20081209:SPDOC_995840920081
                   L’essentiel de l'actualité           56439 2023-04-20 08:42:00      urn:newsml:reuters.com:20110405:SPDOC_1577840520111
                   Brasil                                7938 2023-04-19 23:18:37      urn:newsml:reuters.com:20110719:SPDOC_1248091920111
                   Россия                               30039 2023-04-19 15:29:37      urn:newsml:reuters.com:20140414:SPDOC_1437490142014
Sports & Lifestyle Sport                               113300 2023-04-20 08:44:33        urn:newsml:reuters.com:20020927:SPDOC_66767272002
                   Lifestyle & Entertainment            76934 2023-04-20 08:34:41      urn:newsml:reuters.com:20070301:SPDOC_1688530120071
AWP Top News       AWP German Top News                  96223 2023-04-20 09:39:46  urn:newsml:refinitiv.com:20200301:AWP_TN_DOC_2020030101
                   AWP French Top News                  71096 2023-04-20 09:31:55  urn:newsml:refinitiv.com:20200301:AWP_TN_DOC_2020030102

The following example demonstrates how to get the particular item from the top news hierarchy for the current top news packages:

response = news.top_news.hierarchy.Definition(id=news.top_news.hierarchy.TopNewsId.CURRENT).get_data()

print(response.data.hierarchy["Commodities"])

This example produces the following output:

Response

{'Agricultural Commodities': Subcategory(name='Agricultural Commodities',
                                         revision_id=127135,
                                         revision_date=Timestamp('2023-04-20 09:35:46+0000', tz='UTC'),
                                         top_news_id='urn:newsml:reuters.com:20110214:SPDOC_1568921420111'),
 'Commodities': Subcategory(name='Commodities',
                            revision_id=167004,
                            revision_date=Timestamp('2023-04-20 09:36:35+0000', tz='UTC'),
                            top_news_id='urn:newsml:reuters.com:20060119:SPDOC_28769192006'),
 'Energy': Subcategory(name='Energy',
                       revision_id=170614,
                       revision_date=Timestamp('2023-04-20 09:16:17+0000', tz='UTC'),
                       top_news_id='urn:newsml:reuters.com:20110214:SPDOC_1568591420111'),
 'Global Gas, Power & LNG': Subcategory(name='Global Gas, Power & LNG',
                                        revision_id=92261,
                                        revision_date=Timestamp('2023-04-20 09:36:04+0000', tz='UTC'),
                                        top_news_id='urn:newsml:reuters.com:20110214:SPDOC_1569211420111'),
 'Metals': Subcategory(name='Metals',
                       revision_id=116064,
                       revision_date=Timestamp('2023-04-20 09:21:39+0000', tz='UTC'),
                       top_news_id='urn:newsml:reuters.com:20110214:SPDOC_1568781420111')}

None

93 words (0:29 mins)