GNews Documentation
===================

.. image:: https://img.shields.io/pypi/dm/GNews.svg?style=for-the-badge
   :target: https://pypistats.org/packages/gnews

.. image:: https://img.shields.io/github/stars/ranahaani/GNews.svg?style=for-the-badge
   :target: https://github.com/ranahaani/GNews/stargazers

A lightweight Python package that searches Google News and returns structured article data.
Supports 141+ countries and 41+ languages.

.. toctree::
   :maxdepth: 2
   :caption: Getting Started

   installation
   quickstart

.. toctree::
   :maxdepth: 2
   :caption: Usage Guide

   usage/search
   usage/filtering
   usage/export
   usage/cli
   usage/fulltext
   usage/async
   usage/url-resolution

.. toctree::
   :maxdepth: 2
   :caption: Backends

   backends/rss
   backends/searchapi

.. toctree::
   :maxdepth: 2
   :caption: Reference

   reference/api
   reference/exceptions
   reference/countries
   reference/languages

.. toctree::
   :maxdepth: 1
   :caption: Project

   changelog
   contributing