Build a News Aggregator
This guide takes you through the process of building a news aggregator with the NewsCatcher news API.
News aggregators can do a lot of things, but at the core of things, they all need to scrape, clean, and organize news information from multiple sources. In this guide, you'll go through the process of building a news aggregator using NewsCatcher's news API(in less than 10 mins).
Here's what you'll need to follow along with this guide:
- URLs of the news outlets you want to aggregate
- Python 3
- The following Python modules
newscatcherapi
tldextract
Install the required modules using pip:
pip install newscatcherapi tldextract
To get the clean URLs of the news outlets, you can use the following function:
import tldextract
def clean_the_url(url):
clean_url = '.'.join(list(tldextract.extract(url))[1:]).replace('www.', '').lower()
return clean_url
If you're working with international news outlets and want a specific regional website, you can use the
lang parameter to get it. For example, if you want to get the news articles for 'arabic.rt.com' and 'francais.rt.com', you can't just use the clean URL because it will be the same for both of them, 'rt.com'. Once you have the clean URLs of the news sources you want to aggregate, you can simply pass them as a list to the sources parameter of the
v2/search endpoint to get the articles. And that's it!Let's say you wanted to aggregate all news articles from The New York Times and The Guardian published in the last week.
All you would need to do is use the
get_search() method to fetch the articles:from newscatcherapi import NewsCatcherApiClient
newscatcherapi = NewsCatcherApiClient(x_api_key='your_key_1')
clean_urls = ['nytimes.com', 'theguardian.com']
aggregated_articles = newscatcherapi.get_search(q='*',
from_ = "1 week ago",
page_size = 100,
sources = clean_urls))
Alternatively, if you're not working with Python you can make a GET request with the clean URLs:
curl -XGET 'https://api.newscatcherapi.com//v2/search?q=*%20page_size=100%20sources=nytimes.com,theguardian.com%20from=1 week ago' -H 'x-api-key: your_key_1'
Which would yield a JSON/Dictionary object that looks like this:
{
"status": "ok",
"total_hits": 3183,
"page": 1,
"total_pages": 32,
"page_size": 100,
"articles": [
{
"title": "The E.U. unveils a plan to ban Russian oil imports.",
"author": "Matina Stevis-Gridneff",
"published_date": "2022-05-04 07:12:29",
"published_date_precision": "full",
"link": "https://www.nytimes.com/2022/05/04/world/eu-russia-oil-ban.html",
"clean_url": "nytimes.com",
...
}
...
],
,
"user_input": {
"q": "*",
"search_in": [
"title_summary"
],
"lang": null,
"not_lang": null,
"countries": null,
"not_countries": null,
"from": "2022-05-02 05:28:11",
"to": null,
"ranked_only": "True",
"from_rank": null,
"to_rank": null,
"sort_by": "relevancy",
"page": 1,
"size": 100,
"sources": [
"nytimes.com",
"theguardian.com"
],
"not_sources": null,
"topic": null,
"published_date_precision": null
}
}
You can now extract the articles list from this and use them however you like.
CryptoCatcher in action
Did we miss any outlets you need? Reach out to us at [email protected], we'll add it without breaking a sweat.
Last modified 6mo ago