Metadata-Version: 2.1
Name: ycnbc
Version: 1.0.3
Summary: Download data from CNBC!
Home-page: https://github.com/asepscareer/ycnbc
Author: Asep Saputra
Author-email: asepscareer@gmail.com
License: Apache
Keywords: scrape news,cnbc library,cnbc python,cnbc api
Platform: any
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: News/Diary
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt

# Download news data from CNBC! CNBC's API

<table border=1 cellpadding=10><tr><td>

#### \*\*\* IMPORTANT LEGAL DISCLAIMER \*\*\*

---

ycnbc is **not** affiliated, endorsed, or vetted by CNBC, It's an open source tool that uses Web Scraping and is intended for research and educational purposes.
</td></tr></table>

---

**ycnbc** offers a threaded and Pythonic way to news and market data from [CNBC](https://www.cnbc.com).

[Changelog »](https://github.com/asepscareer/ycnbc/blob/master/CHANGELOG.rst)

---

## Quick Start

---
### Requirements

- Python >=3.5+
- pandas>=0.24.0
- requests>=2.23.0
- lxml>=4.5.1

---
### Installation

```
$ pip install ycnbc --upgrade --no-cache-dir
```

---

### Usage

```python
import ycnbc

# get trending news
trending_ = ycnbc.get_trendingnews() # return DataFrame

# get latest news
latest_ = ycnbc.get_latestnews() # return DataFrame

# get data by categories or urls
data_ = ycnbc.get_datanews('economy') # return DataFrame
```

or,

```python
categories = [
    'world-economy', 'central-banks', 'jobs',
    'economy', 'health-and-science', 'media',
    'climate', 'wealth', 'life',
    'small-business', 'finance',
    'transportation', 'real-estate', 'internet',
    'white-house', 'policy', 'congress',
    'hospitals', 'life-and-health-insurance'
    ]
for i in categories:
    print("category =========> {}".format(i))
    print(ycnbc.get_datanews(i))
```

Note ->

1. The category parameter is a URL.
For example, if you want to retrieve data from the url https://www.cnbc.com/economy/, then you can simply call it `ycnbc.get_datanews('economy')`. This means that there is still a lot of data that you can take apart from the one attached above.

2. URL pages containing news content that have the `PRO` tag still cannot be retrieved using this library.

---

### Legal Stuff

**ycnbc** is distributed under the **Apache Software License**. See
the [LICENSE.txt](./LICENSE.txt) file in the release for details.

---

### P.S.

Please drop me an note with any feedback you have.

**Asep Saputra**


