From ba8d2f41be9618a6f1112355082c892d3c3e1177 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Thu, 6 Mar 2025 17:44:47 -0800 Subject: [PATCH 01/17] Update README.rst --- README.rst | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/README.rst b/README.rst index 21373ba7..0b25308e 100644 --- a/README.rst +++ b/README.rst @@ -163,9 +163,18 @@ If you are certain that an *entire* news source is in one language, **go ahead a 两年双免0手续0利率 科鲁兹掀背金融轻松购_武汉车市_武汉汽 车网_新浪汽车_新浪网 -Support our library -------------------- -`It takes only one click`_ + + +Enjoy Newspaper3k? You'll also love BrightData +---------------------------------------------- +`Click here to see BrightData`_, the premier company offering the internet's most trusted web data. +They have AI-powered web scrapers and datasets you may find useful. + +.. image:: https://github.com/user-attachments/assets/ca540b8b-7888-49d2-89df-2c07760f6d9f + :target: https://get.brightdata.com/hm89s0nowetp + :alt: Bright Data's Scraping Browser Product + +.. _`Click here to see BrightData`: https://get.brightdata.com/hm89s0nowetp Docs ---- From b39a4b407fd322eb4d256d29170ad69a0a39eb7a Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Thu, 10 Jul 2025 23:25:16 -0700 Subject: [PATCH 02/17] Update README.rst include sponsors --- README.rst | 38 ++++++++++++++++++++------------------ 1 file changed, 20 insertions(+), 18 deletions(-) diff --git a/README.rst b/README.rst index 0b25308e..1d0f7b5b 100644 --- a/README.rst +++ b/README.rst @@ -164,17 +164,16 @@ If you are certain that an *entire* news source is in one language, **go ahead a 车网_新浪汽车_新浪网 +Enjoy Newspaper3k? +------------------ +`Click here to see SerpAPI`_, scrape search engines easily with SerpAPI - Search API. +They scrape Google Search, Google News, Google Maps, and more! -Enjoy Newspaper3k? You'll also love BrightData ----------------------------------------------- -`Click here to see BrightData`_, the premier company offering the internet's most trusted web data. -They have AI-powered web scrapers and datasets you may find useful. +.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 + :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github + :alt: Scrape search engines easily with SerpAPI - Search API. -.. image:: https://github.com/user-attachments/assets/ca540b8b-7888-49d2-89df-2c07760f6d9f - :target: https://get.brightdata.com/hm89s0nowetp - :alt: Bright Data's Scraping Browser Product - -.. _`Click here to see BrightData`: https://get.brightdata.com/hm89s0nowetp +.. _`Click here to see SerpAPI`: https://serpapi.com?utm_source=newspaper3k_github Docs ---- @@ -245,6 +244,18 @@ Features zh Chinese +BrightData offers top quality web scraping with little effort! +-------------------------------------------------------------- +`Click here to see BrightData`_, the premier company offering the internet's most trusted web data. +They have AI-powered web scrapers and datasets you may find useful. + +.. image:: https://github.com/user-attachments/assets/ca540b8b-7888-49d2-89df-2c07760f6d9f + :target: https://get.brightdata.com/hm89s0nowetp + :alt: Bright Data's Scraping Browser Product + +.. _`Click here to see BrightData`: https://get.brightdata.com/hm89s0nowetp + + Get it now ---------- @@ -311,15 +322,6 @@ NOTE: You will still most likely need to install the following libraries via you $ curl https://raw.githubusercontent.com/codelucas/newspaper/master/download_corpora.py | python3 -Donations ---------- - -Your donations are greatly appreciated! They will free me up to work on this project more, -to take on things like: adding new features, bug-fix support, addressing concerns with the library. - -- My PayPal link: `https://www.paypal.me/codelucas`_ -- My `Venmo`_ handle: @Lucas-Ou-Yang - Development ----------- From 1b5fce18d4ce8a75ae7f6da26b874354bd9ce243 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Thu, 10 Jul 2025 23:35:11 -0700 Subject: [PATCH 03/17] Update README.rst - more sponsors --- README.rst | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/README.rst b/README.rst index 1d0f7b5b..774c116c 100644 --- a/README.rst +++ b/README.rst @@ -244,17 +244,22 @@ Features zh Chinese -BrightData offers top quality web scraping with little effort! --------------------------------------------------------------- -`Click here to see BrightData`_, the premier company offering the internet's most trusted web data. -They have AI-powered web scrapers and datasets you may find useful. +BrightData: Scrape Any Website, at Scale, Without Getting Blocked +----------------------------------------------------------------- +👉 `Get instant access to BrightData’s AI-powered web scraping tools and datasets.`_ + +* ✅ AI-powered scraping browser +* ✅ 72M+ rotating IPs +* ✅ Zero bans, faster extraction +* `👉 Get access now.`_ .. image:: https://github.com/user-attachments/assets/ca540b8b-7888-49d2-89df-2c07760f6d9f :target: https://get.brightdata.com/hm89s0nowetp :alt: Bright Data's Scraping Browser Product -.. _`Click here to see BrightData`: https://get.brightdata.com/hm89s0nowetp +.. _`Get instant access to BrightData’s AI-powered web scraping tools and datasets.`: https://get.brightdata.com/hm89s0nowetp +.. _`👉 Get access now.`: https://get.brightdata.com/hm89s0nowetp Get it now ---------- From bde5d50f5de80dd0beaa6ed3044b07a6f3888417 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Fri, 11 Jul 2025 07:52:35 -0700 Subject: [PATCH 04/17] Update README.rst - sponsors --- README.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README.rst b/README.rst index 774c116c..b1c05e53 100644 --- a/README.rst +++ b/README.rst @@ -166,14 +166,14 @@ If you are certain that an *entire* news source is in one language, **go ahead a Enjoy Newspaper3k? ------------------ -`Click here to see SerpAPI`_, scrape search engines easily with SerpAPI - Search API. -They scrape Google Search, Google News, Google Maps, and more! +`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. +Scrape Google Search, Google News, Google Maps, and more! .. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github - :alt: Scrape search engines easily with SerpAPI - Search API. + :alt: Scrape search engines easily with SerpApi - Search API. -.. _`Click here to see SerpAPI`: https://serpapi.com?utm_source=newspaper3k_github +.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github Docs ---- From 6c1dcddd3af2373dfe17f9646558e60e2d74688d Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Thu, 14 Aug 2025 15:56:11 +0700 Subject: [PATCH 05/17] Update README.rst --- README.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.rst b/README.rst index b1c05e53..04d56692 100644 --- a/README.rst +++ b/README.rst @@ -175,6 +175,18 @@ Scrape Google Search, Google News, Google Maps, and more! .. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github +Interested in proxies? +---------------------- + +`Click here to explore BestProxy`_, your go-to solution for premium residential proxies. BestProxy's proxies ensure smooth browsing, fast speeds, and total anonymity. `Get Started`_ today and experience the difference! + +.. image:: https://github.com/user-attachments/assets/1c6ef38c-f0c0-4db0-aad2-3ed9d6adf0b5 + :target: https://bestproxy.com/?keyword=b2vgzl0r + :alt: Experience BestProxy, smooth browsing, fast speeds, and total anonymity. + +.. _`Click here to explore BestProxy`: https://bestproxy.com/?keyword=b2vgzl0r +.. _`Get Started`: https://bestproxy.com/?keyword=b2vgzl0r + Docs ---- From 8901de7451320ce616aea613ab91e81e7cedd289 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Tue, 14 Oct 2025 22:41:54 +0700 Subject: [PATCH 06/17] remove bd from readme ads --- README.rst | 18 ------------------ 1 file changed, 18 deletions(-) diff --git a/README.rst b/README.rst index 04d56692..2ff3c022 100644 --- a/README.rst +++ b/README.rst @@ -255,24 +255,6 @@ Features vi Vietnamese zh Chinese - -BrightData: Scrape Any Website, at Scale, Without Getting Blocked ------------------------------------------------------------------ -👉 `Get instant access to BrightData’s AI-powered web scraping tools and datasets.`_ - -* ✅ AI-powered scraping browser -* ✅ 72M+ rotating IPs -* ✅ Zero bans, faster extraction -* `👉 Get access now.`_ - -.. image:: https://github.com/user-attachments/assets/ca540b8b-7888-49d2-89df-2c07760f6d9f - :target: https://get.brightdata.com/hm89s0nowetp - :alt: Bright Data's Scraping Browser Product - -.. _`Get instant access to BrightData’s AI-powered web scraping tools and datasets.`: https://get.brightdata.com/hm89s0nowetp - -.. _`👉 Get access now.`: https://get.brightdata.com/hm89s0nowetp - Get it now ---------- From 546c4cd6179f31264ec732fb30fb90f083746b1f Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Wed, 22 Oct 2025 20:52:44 -0700 Subject: [PATCH 07/17] Add Thordata + proxy example --- README.rst | 62 +++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 50 insertions(+), 12 deletions(-) diff --git a/README.rst b/README.rst index 2ff3c022..9421b019 100644 --- a/README.rst +++ b/README.rst @@ -133,6 +133,40 @@ If no language is specified, Newspaper will attempt to auto detect a language. 港特首梁振英就住宅违建事件道歉 +Proxy Usage +=========== +Newspaper3K supports proxies. Here is an example using `Thordata Proxies`_, a reliable proxy service suitable for AI and global web scraping scenarios. + +.. code-block:: pycon + + from newspaper import Article + from newspaper import Configuration + + # Configure ThorData proxy + config = Configuration() + config.proxies = { + 'https': 'https://td-customer-USERNAME:PASSWORD@t.pr.thordata.net:9999' + } + + # Download and parse an article through the proxy + article = Article('https://www.nytimes.com/2024/01/15/technology/ai-trends.html', config=config) + article.download() + article.parse() + print(f"Title: {article.title}") + +`Click here to get a free trial of ThorData`_ + +.. image:: https://github.com/user-attachments/assets/27c4288e-4507-4100-9127-ae2960af287a + :target: https://affiliate.thordata.com/tzc4taw66x3b + :alt: ThorData proxies + +.. _`Thordata Proxies`: https://affiliate.thordata.com/tzc4taw66x3b +.. _`Click here to get a free trial of ThorData`: https://affiliate.thordata.com/tzc4taw66x3b + + +Multi-lingual +============= + If you are certain that an *entire* news source is in one language, **go ahead and use the same api :)** .. code-block:: pycon @@ -164,20 +198,11 @@ If you are certain that an *entire* news source is in one language, **go ahead a 车网_新浪汽车_新浪网 -Enjoy Newspaper3k? ------------------- -`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. -Scrape Google Search, Google News, Google Maps, and more! - -.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 - :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github - :alt: Scrape search engines easily with SerpApi - Search API. - -.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github - Interested in proxies? ----------------------- +====================== +Stay private, fast, and fully in control +---------------------------------------- `Click here to explore BestProxy`_, your go-to solution for premium residential proxies. BestProxy's proxies ensure smooth browsing, fast speeds, and total anonymity. `Get Started`_ today and experience the difference! .. image:: https://github.com/user-attachments/assets/1c6ef38c-f0c0-4db0-aad2-3ed9d6adf0b5 @@ -187,6 +212,19 @@ Interested in proxies? .. _`Click here to explore BestProxy`: https://bestproxy.com/?keyword=b2vgzl0r .. _`Get Started`: https://bestproxy.com/?keyword=b2vgzl0r + +Unlock the Web — the Smart Way +------------------------------ +`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. +Scrape Google Search, Google News, Google Maps, and more! + +.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 + :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github + :alt: Scrape search engines easily with SerpApi - Search API. + +.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github + + Docs ---- From 90441f027e6fee3d75b9966d2af90e4dcb4f7577 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Mon, 3 Nov 2025 00:32:49 -0800 Subject: [PATCH 08/17] Update README with new proxy services and remove old content --- README.rst | 65 +++++++++++++++++++++++++++++++----------------------- 1 file changed, 37 insertions(+), 28 deletions(-) diff --git a/README.rst b/README.rst index 9421b019..73b93687 100644 --- a/README.rst +++ b/README.rst @@ -133,6 +133,16 @@ If no language is specified, Newspaper will attempt to auto detect a language. 港特首梁振英就住宅违建事件道歉 +Newspaper works better with proxies +=================================== +Click here to try `RapidProxy`_, your all-in-one proxy solution. Enjoy unlimited, never-expiring traffic, fast and stable connections, and full anonymity. Start your free test today and experience hassle-free, reliable proxy services worldwide! + +.. image:: https://github.com/user-attachments/assets/719da34a-a0d1-4ee0-81fb-c626d7163616 + :target: https://www.rapidproxy.io/?ref=gitnew + :alt: Experience RapidProxy, your all-in-one proxy solution. Enjoy unlimited, never-expiring traffic, fast and stable connections. + +.. _`RapidProxy`: https://www.rapidproxy.io/?ref=gitnew + Proxy Usage =========== Newspaper3K supports proxies. Here is an example using `Thordata Proxies`_, a reliable proxy service suitable for AI and global web scraping scenarios. @@ -198,33 +208,6 @@ If you are certain that an *entire* news source is in one language, **go ahead a 车网_新浪汽车_新浪网 -Interested in proxies? -====================== - -Stay private, fast, and fully in control ----------------------------------------- -`Click here to explore BestProxy`_, your go-to solution for premium residential proxies. BestProxy's proxies ensure smooth browsing, fast speeds, and total anonymity. `Get Started`_ today and experience the difference! - -.. image:: https://github.com/user-attachments/assets/1c6ef38c-f0c0-4db0-aad2-3ed9d6adf0b5 - :target: https://bestproxy.com/?keyword=b2vgzl0r - :alt: Experience BestProxy, smooth browsing, fast speeds, and total anonymity. - -.. _`Click here to explore BestProxy`: https://bestproxy.com/?keyword=b2vgzl0r -.. _`Get Started`: https://bestproxy.com/?keyword=b2vgzl0r - - -Unlock the Web — the Smart Way ------------------------------- -`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. -Scrape Google Search, Google News, Google Maps, and more! - -.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 - :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github - :alt: Scrape search engines easily with SerpApi - Search API. - -.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github - - Docs ---- @@ -381,7 +364,6 @@ Planning on tweaking our full-text algorithm? Add the ``fulltext`` parameter:: $ python3 tests/unit_tests.py fulltext - Demo ---- @@ -389,6 +371,33 @@ View a working online demo here: http://newspaper-demo.herokuapp.com This is another working online demo: http://newspaper.chinazt.cc/ + +Interested in proxies? +====================== + +Stay private, fast, and fully in control +---------------------------------------- +`Click here to explore BestProxy`_, your go-to solution for premium residential proxies. BestProxy's proxies ensure smooth browsing, fast speeds, and total anonymity. `Get Started`_ today and experience the difference! + +.. image:: https://github.com/user-attachments/assets/1c6ef38c-f0c0-4db0-aad2-3ed9d6adf0b5 + :target: https://bestproxy.com/?keyword=b2vgzl0r + :alt: Experience BestProxy, smooth browsing, fast speeds, and total anonymity. + +.. _`Click here to explore BestProxy`: https://bestproxy.com/?keyword=b2vgzl0r +.. _`Get Started`: https://bestproxy.com/?keyword=b2vgzl0r + + +Unlock the Web — the Smart Way +------------------------------ +`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. +Scrape Google Search, Google News, Google Maps, and more! + +.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 + :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github + :alt: Scrape search engines easily with SerpApi - Search API. + +.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github + LICENSE ------- From 4ab043bf08765b3b5d3c141367cd7bf036e8102b Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Sun, 23 Nov 2025 21:43:38 -0800 Subject: [PATCH 09/17] remove thordata advert from readme --- README.rst | 30 ------------------------------ 1 file changed, 30 deletions(-) diff --git a/README.rst b/README.rst index 73b93687..c2a1198d 100644 --- a/README.rst +++ b/README.rst @@ -143,36 +143,6 @@ Click here to try `RapidProxy`_, your all-in-one proxy solution. Enjoy unlimited .. _`RapidProxy`: https://www.rapidproxy.io/?ref=gitnew -Proxy Usage -=========== -Newspaper3K supports proxies. Here is an example using `Thordata Proxies`_, a reliable proxy service suitable for AI and global web scraping scenarios. - -.. code-block:: pycon - - from newspaper import Article - from newspaper import Configuration - - # Configure ThorData proxy - config = Configuration() - config.proxies = { - 'https': 'https://td-customer-USERNAME:PASSWORD@t.pr.thordata.net:9999' - } - - # Download and parse an article through the proxy - article = Article('https://www.nytimes.com/2024/01/15/technology/ai-trends.html', config=config) - article.download() - article.parse() - print(f"Title: {article.title}") - -`Click here to get a free trial of ThorData`_ - -.. image:: https://github.com/user-attachments/assets/27c4288e-4507-4100-9127-ae2960af287a - :target: https://affiliate.thordata.com/tzc4taw66x3b - :alt: ThorData proxies - -.. _`Thordata Proxies`: https://affiliate.thordata.com/tzc4taw66x3b -.. _`Click here to get a free trial of ThorData`: https://affiliate.thordata.com/tzc4taw66x3b - Multi-lingual ============= From 648fb2a18bccb330ce8a0791308fb98936c3de14 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Sat, 6 Dec 2025 08:29:46 +0800 Subject: [PATCH 10/17] remove RapidProxy --- README.rst | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/README.rst b/README.rst index c2a1198d..7ab6805f 100644 --- a/README.rst +++ b/README.rst @@ -132,18 +132,6 @@ If no language is specified, Newspaper will attempt to auto detect a language. >>> print(a.title) 港特首梁振英就住宅违建事件道歉 - -Newspaper works better with proxies -=================================== -Click here to try `RapidProxy`_, your all-in-one proxy solution. Enjoy unlimited, never-expiring traffic, fast and stable connections, and full anonymity. Start your free test today and experience hassle-free, reliable proxy services worldwide! - -.. image:: https://github.com/user-attachments/assets/719da34a-a0d1-4ee0-81fb-c626d7163616 - :target: https://www.rapidproxy.io/?ref=gitnew - :alt: Experience RapidProxy, your all-in-one proxy solution. Enjoy unlimited, never-expiring traffic, fast and stable connections. - -.. _`RapidProxy`: https://www.rapidproxy.io/?ref=gitnew - - Multi-lingual ============= From 1f6e1770c95468d862d86084d290aa8b0e8b5db7 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Mon, 23 Mar 2026 09:04:29 +0800 Subject: [PATCH 11/17] change git attributes --- .gitattributes | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.gitattributes b/.gitattributes index 4cb342ff..f8c996b6 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1,2 +1,2 @@ docs/* linguist-documentation -tests/* linguist-vendored +tests/** linguist-vendored From 72ba63387685b5735ced3a582858596714e52773 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Fri, 10 Apr 2026 21:52:46 +0800 Subject: [PATCH 12/17] add ceointerviews --- README.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/README.rst b/README.rst index 7ab6805f..dfd3f398 100644 --- a/README.rst +++ b/README.rst @@ -13,6 +13,23 @@ Newspaper3k: Article scraping & curation :target: https://coveralls.io/github/codelucas/newspaper :alt: Coverage status +.. raw:: html + +
+

From the author of newspaper: CEOInterviews — the world's largest verified database of executive interviews. 20,000+ CEOs, 1M+ quotes, and full transcripts. Every quote is AI + human verified to the original primary source, so your research tools never hallucinate a CEO soundbite again.

+ + + + + + + + + +
❌ Other generic news APIs✅ CEOInterviews
Unverified, misattributed Elon Musk quoteCEOInterviews AI + human verified primary source
+

Ask "What has Elon Musk said about tariffs?" — you get speaker-authenticated transcripts with source URLs, not SEO-spam blog paraphrases.

+

👉 Explore CEOInterviews and grab a REST API key at ceointerviews.ai  —  an MCP server is also available for Claude / Cursor / ChatGPT agents (link).

+
Inspired by `requests`_ for its simplicity and powered by `lxml`_ for its speed: From bfd7f5cc39f151e4d403fcb37d7e687f44d0e353 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Thu, 16 Apr 2026 18:09:58 +0700 Subject: [PATCH 13/17] webshare proxy --- README.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.rst b/README.rst index dfd3f398..2ce8b217 100644 --- a/README.rst +++ b/README.rst @@ -350,6 +350,16 @@ This is another working online demo: http://newspaper.chinazt.cc/ Interested in proxies? ====================== +Skip the scraping headaches — get proxies that actually work +------------------------------------------------------------ +`Click here to try Webshare`_, the proxy network built for devs who scrape at scale. Get 80M+ residential IPs, blazing-fast datacenter proxies, and a free tier that actually lets you test before you commit. No contracts, no nonsense — just proxies that don't get blocked. + +.. image:: https://github.com/user-attachments/assets/af3431bb-6436-485b-b354-10828692803d + :target: https://www.webshare.io/?referral_code=eb53spijl2ih + :alt: Webshare — reliable proxies built for developers and scrapers. +.. _`Click here to try Webshare`: https://www.webshare.io/?referral_code=eb53spijl2ih +.. _`Start Scraping`: https://www.webshare.io/?referral_code=eb53spijl2ih + Stay private, fast, and fully in control ---------------------------------------- `Click here to explore BestProxy`_, your go-to solution for premium residential proxies. BestProxy's proxies ensure smooth browsing, fast speeds, and total anonymity. `Get Started`_ today and experience the difference! From dc5c2a3c7cb1883ae611afa51aa0e43039c44943 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Sat, 9 May 2026 19:33:37 +0700 Subject: [PATCH 14/17] remove ceointerviews --- README.rst | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/README.rst b/README.rst index 2ce8b217..f72b076b 100644 --- a/README.rst +++ b/README.rst @@ -15,22 +15,6 @@ Newspaper3k: Article scraping & curation .. raw:: html -
-

From the author of newspaper: CEOInterviews — the world's largest verified database of executive interviews. 20,000+ CEOs, 1M+ quotes, and full transcripts. Every quote is AI + human verified to the original primary source, so your research tools never hallucinate a CEO soundbite again.

- - - - - - - - - -
❌ Other generic news APIs✅ CEOInterviews
Unverified, misattributed Elon Musk quoteCEOInterviews AI + human verified primary source
-

Ask "What has Elon Musk said about tariffs?" — you get speaker-authenticated transcripts with source URLs, not SEO-spam blog paraphrases.

-

👉 Explore CEOInterviews and grab a REST API key at ceointerviews.ai  —  an MCP server is also available for Claude / Cursor / ChatGPT agents (link).

-
- Inspired by `requests`_ for its simplicity and powered by `lxml`_ for its speed: "Newspaper is an amazing python library for extracting & curating articles." From b97791d8f5187387782ca0f8b5de19b996f7f258 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Wed, 13 May 2026 11:02:33 +0700 Subject: [PATCH 15/17] add swiftproxy --- README.rst | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) diff --git a/README.rst b/README.rst index f72b076b..462f2a69 100644 --- a/README.rst +++ b/README.rst @@ -167,6 +167,50 @@ If you are certain that an *entire* news source is in one language, **go ahead a 车网_新浪汽车_新浪网 +Scraping at scale: avoiding IP blocks +===================================== + +Once you move past scraping a handful of articles, you'll hit the same wall every news scraper hits: 403s, captchas, rate limits, and silent shadow bans. Your code is fine — your IP is the problem. The fix is rotating residential proxies. + +I personally route my own newspaper3k pipelines through `Swiftproxy`_ — 80M+ residential IPs across 195+ countries, a 99.89% success rate, non-expiring traffic, and a free trial so you can pressure-test it before paying. Plugging it into newspaper3k takes about four lines: + +.. code-block:: python + + from newspaper import Article, Config + + config = Config() + config.proxies = { + 'http': 'http://USERNAME:PASSWORD@gate.swiftproxy.net:7777', + 'https': 'http://USERNAME:PASSWORD@gate.swiftproxy.net:7777', + } + # a real browser UA helps too + config.browser_user_agent = ( + 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ' + 'AppleWebKit/537.36 (KHTML, like Gecko) ' + 'Chrome/124.0.0.0 Safari/537.36' + ) + config.request_timeout = 20 + + article = Article('https://example.com/some-news-story', config=config) + article.download() + article.parse() + print(article.title) + +The same ``config`` object works with ``newspaper.build()`` — every article fetched by the source will rotate through residential IPs automatically: + +.. code-block:: python + + import newspaper + paper = newspaper.build('http://cnn.com', config=config, memoize_articles=False) + for article in paper.articles: + article.download() + article.parse() + +Grab credentials and a free trial at `swiftproxy.net `_. Use code ``PROXY90`` for 10% off your first plan. + +.. _`Swiftproxy`: https://www.swiftproxy.net/?ref=codelucas + + Docs ---- @@ -333,6 +377,16 @@ This is another working online demo: http://newspaper.chinazt.cc/ Interested in proxies? ====================== +Power your scraping and automation at real-world scale +------------------------------------------------------ +`Click here to try Swiftproxy`_ — built for developers running scraping, automation, and data collection workflows at scale. Access 80M+ residential IPs from $0.7/GB, fast ISP proxies from $6/IP, global coverage across 195+ countries, non-expiring traffic, and a 99.89% success rate. Free trial available — use code ``PROXY90`` for 10% off. + +.. image:: https://github.com/user-attachments/assets/913f1fd6-20e9-4f37-89b7-ba6b0bd0724a + :target: https://www.swiftproxy.net/?ref=codelucas + :alt: Swiftproxy — residential and ISP proxies built for scrapers and developers. + +.. _`Click here to try Swiftproxy`: https://www.swiftproxy.net/?ref=codelucas + Skip the scraping headaches — get proxies that actually work ------------------------------------------------------------ From 15f6701e3a8dea3eff3dd09e6cab4b025ff46ee9 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Thu, 9 Jul 2026 02:33:52 +0800 Subject: [PATCH 16/17] adjustments to readme and readthedocs --- .readthedocs.yaml | 9 +++++++ README.rst | 63 +++++++++++++++++++++++++++++++++++------------ docs/index.rst | 15 +++++++++++ 3 files changed, 71 insertions(+), 16 deletions(-) create mode 100644 .readthedocs.yaml diff --git a/.readthedocs.yaml b/.readthedocs.yaml new file mode 100644 index 00000000..fb179079 --- /dev/null +++ b/.readthedocs.yaml @@ -0,0 +1,9 @@ +version: 2 + +build: + os: ubuntu-24.04 + tools: + python: "3.12" + +sphinx: + configuration: docs/conf.py diff --git a/README.rst b/README.rst index 462f2a69..6832767f 100644 --- a/README.rst +++ b/README.rst @@ -13,8 +13,6 @@ Newspaper3k: Article scraping & curation :target: https://coveralls.io/github/codelucas/newspaper :alt: Coverage status -.. raw:: html - Inspired by `requests`_ for its simplicity and powered by `lxml`_ for its speed: "Newspaper is an amazing python library for extracting & curating articles." @@ -167,6 +165,38 @@ If you are certain that an *entire* news source is in one language, **go ahead a 车网_新浪汽车_新浪网 +Scraping by topic: where do the URLs come from? +=============================================== + +``newspaper.build()`` is perfect when you know *which sites* to crawl. But the other question I get constantly is: "I want every article about **X**, across all publications — where do I get the URLs?" The answer is to search Google News for your keyword first, then feed the result links straight into newspaper for extraction. + +The easiest way to query Google News programmatically is the `Google News API`_ from `SerpApi - Search API`_ (they also cover Google Search, Google Maps, and more). The two libraries snap together in a few lines: + +.. code-block:: python + + # pip3 install google-search-results + from serpapi import GoogleSearch + from newspaper import Article + + search = GoogleSearch({ + "engine": "google_news", + "q": "electric vehicles", + "api_key": "YOUR_SERPAPI_KEY", # free plan at serpapi.com + }) + + for result in search.get_dict()["news_results"]: + article = Article(result["link"]) + article.download() + article.parse() + article.nlp() + print(article.title, "--", article.summary[:120]) + +This pattern of SerpApi for *discovery*, newspaper3k for *extraction*, is how most production news-monitoring pipelines are built, and it sidesteps writing a crawler for every source you care about. + +.. _`SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github +.. _`Google News API`: https://serpapi.com/google-news-api?utm_source=newspaper3k_github + + Scraping at scale: avoiding IP blocks ===================================== @@ -375,8 +405,21 @@ View a working online demo here: http://newspaper-demo.herokuapp.com This is another working online demo: http://newspaper.chinazt.cc/ -Interested in proxies? -====================== +Interested in scraping APIs & proxies? +====================================== + +Unlock the Web — the Smart Way +------------------------------ +`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. +Scrape Google Search, Google News, Google Maps, and more! + +.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 + :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github + :alt: Scrape search engines easily with SerpApi - Search API. + +.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github + + Power your scraping and automation at real-world scale ------------------------------------------------------ `Click here to try Swiftproxy`_ — built for developers running scraping, automation, and data collection workflows at scale. Access 80M+ residential IPs from $0.7/GB, fast ISP proxies from $6/IP, global coverage across 195+ countries, non-expiring traffic, and a 99.89% success rate. Free trial available — use code ``PROXY90`` for 10% off. @@ -409,18 +452,6 @@ Stay private, fast, and fully in control .. _`Click here to explore BestProxy`: https://bestproxy.com/?keyword=b2vgzl0r .. _`Get Started`: https://bestproxy.com/?keyword=b2vgzl0r - -Unlock the Web — the Smart Way ------------------------------- -`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`_. -Scrape Google Search, Google News, Google Maps, and more! - -.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 - :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_github - :alt: Scrape search engines easily with SerpApi - Search API. - -.. _`Click here to see SerpApi, scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_github - LICENSE ------- diff --git a/docs/index.rst b/docs/index.rst index 111ae633..b4e0bae7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -352,6 +352,21 @@ Newspaper uses a lot of `python-goose's`_ parsing code. View their license `here Please feel free to `email & contact me`_ if you run into issues or just would like to talk about the future of this library and news extraction in general! +Sponsored by SerpApi +-------------------- + +`Scrape search engines easily with SerpApi - Search API`_. +Scrape Google Search, Google News, Google Maps, and more! Their `Google News API`_ +pairs perfectly with newspaper: use it to discover article URLs by keyword, then +extract them with ``Article``. + +.. image:: https://github.com/user-attachments/assets/9a80eeb4-72a8-43f1-9413-93c7a47b2bf6 + :target: https://serpapi.com/google-news-api?utm_source=newspaper3k_docs + :alt: Scrape search engines easily with SerpApi - Search API. + +.. _`Scrape search engines easily with SerpApi - Search API`: https://serpapi.com?utm_source=newspaper3k_docs +.. _`Google News API`: https://serpapi.com/google-news-api?utm_source=newspaper3k_docs + .. _`Lucas Ou-Yang`: http://codelucas.com .. _`email & contact me`: mailto:lucasyangpersonal@gmail.com .. _`python-goose's`: https://github.com/grangier/python-goose From 8f501b693bfe5c5847ebff755204b9451937d372 Mon Sep 17 00:00:00 2001 From: Lucas Ou-Yang Date: Tue, 21 Jul 2026 20:26:35 +0700 Subject: [PATCH 17/17] remove webshare --- README.rst | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/README.rst b/README.rst index 6832767f..dcbee056 100644 --- a/README.rst +++ b/README.rst @@ -431,16 +431,6 @@ Power your scraping and automation at real-world scale .. _`Click here to try Swiftproxy`: https://www.swiftproxy.net/?ref=codelucas -Skip the scraping headaches — get proxies that actually work ------------------------------------------------------------- -`Click here to try Webshare`_, the proxy network built for devs who scrape at scale. Get 80M+ residential IPs, blazing-fast datacenter proxies, and a free tier that actually lets you test before you commit. No contracts, no nonsense — just proxies that don't get blocked. - -.. image:: https://github.com/user-attachments/assets/af3431bb-6436-485b-b354-10828692803d - :target: https://www.webshare.io/?referral_code=eb53spijl2ih - :alt: Webshare — reliable proxies built for developers and scrapers. -.. _`Click here to try Webshare`: https://www.webshare.io/?referral_code=eb53spijl2ih -.. _`Start Scraping`: https://www.webshare.io/?referral_code=eb53spijl2ih - Stay private, fast, and fully in control ---------------------------------------- `Click here to explore BestProxy`_, your go-to solution for premium residential proxies. BestProxy's proxies ensure smooth browsing, fast speeds, and total anonymity. `Get Started`_ today and experience the difference!