Skip to main content

Get Started with GNews API

Welcome to GNews API. Start building with our news API in minutes and access over 60,000 news sources worldwide.

What is GNews API?​

GNews API is a reliable REST news API that provides access to current and historic news articles from over 60,000 sources worldwide. With this news API, you can retrieve top headlines based on Google News rankings and search through comprehensive news archives. Originally built to replace the discontinued Google News API, GNews has grown into a comprehensive news service trusted by developers and businesses. Our platform delivers consistent, high-quality news data through a straightforward API. This documentation shows you how to use the API effectively, with clear examples in JavaScript, Python, C#, PHP and Bash to help you integrate news data into your applications quickly.

Quick Start Guide​

1. Create Your Account​

Get started in seconds:

  1. Sign up for free - no credit card required
  2. Verify your email address
  3. Access your dashboard to get your API key

2. Make Your First API Call​

All API requests follow this simple pattern:

https://gnews.io/api/v4/{endpoint}?{parameters}&apikey=YOUR_API_KEY

Try this example in your browser or terminal:

https://gnews.io/api/v4/search?q=Google&lang=en&max=5&apikey=YOUR_API_KEY

3. Choose Your Endpoint​

Want to search for specific news? Start with the Search Endpoint to find articles matching keywords.

Need the top headlines? Explore the Top Headlines Endpoint based on Google News rankings.

Two Powerful Endpoints​

Search Endpoint​

Perfect for finding specific news stories with advanced filtering options.

Use cases:

  • Keyword-based news search
  • Date range filtering
  • Language and country targeting
  • Boolean search operators

Learn more

Top Headlines Endpoint​

Get trending articles based on Google News rankings across 9 categories.

Categories available:

  • General
  • World
  • Nation
  • Business
  • Technology
  • Entertainment
  • Sports
  • Science
  • Health

Learn more

Next Steps​

Community & Support​

  • GitHub - Sample projects and integrations
  • Email Support - Get help from our team
  • FAQ - Common questions answered

Ready to Build?​

Your journey starts here. Create your free account and make your first API call in under 2 minutes.

Get Your API Key