GNews Documentation

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

Getting Started

• Installation
  • Basic Install
  • With Full Article Support
  • With Real URL Resolution
  • Install all extras
  • Development Install
• Quickstart
  • Search news
  • Top headlines
  • Filter by language and country
  • What you get back

Usage Guide

• Searching News
  • By keyword
  • Top headlines
  • By topic
  • By location
  • By site
• Filtering Results
  • Initialization parameters
  • Update after creation
  • Period format
  • Date range
• Exporting Results
  • Save to JSON
  • Save to CSV
  • Both methods return the path
• CLI Usage
  • Commands
  • Common options
  • JSON output
• Getting Full Article Text
  • Install
  • Usage
  • Return value
  • Error handling
  • Limitations
• Async Support
  • Basic usage
  • Concurrent queries
  • Available async methods
  • With SearchApi backend
  • FastAPI integration
  • Notes
• URL Resolution
  • The problem
  • Solution: Playwright extra
  • Fallback behavior
  • Success rate
  • Production alternative
  • Manual resolution

Backends

• RSS Backend (Default)
  • How it works
  • Article fields
  • Limitations
  • Usage
• SearchApi Backend
  • Setup
  • Benefits over RSS
  • Extra article fields
  • Pagination
  • Notes

Reference

• API Reference
  • GNews
  • Article Properties
• Exceptions
  • NetworkError
  • InvalidConfigError
  • RateLimitError
  • GNewsException
• Supported Countries
• Supported Languages

Project

• Changelog
• Contributing