Get Started with GNews API
This page takes you from sign-up to your first request, then helps you choose the endpoint that fits.
What is GNews API?
GNews API is a real-time news API for developers. Search articles from 80,000+ sources, or get top headlines in 41 languages and 71 countries, returned as JSON. Top headlines are based on Google News rankings.
The code examples in this documentation are in cURL, Python, JavaScript, PHP, and C#.
Quick start guide
1. Create your account
- Sign up for free. No credit card needed.
- Verify your email address with the code we email you. If you sign up with Google, it's already verified.
- Copy your API key from the dashboard.
2. Make your first request
Every request follows this pattern:
GEThttps://gnews.io/api/v4/{endpoint}?{parameters}&apikey=YOUR_API_KEYTry this one in your browser or terminal:
GEThttps://gnews.io/api/v4/search?q=AI&lang=en&apikey=YOUR_API_KEY3. Choose your endpoint
Looking for articles about a topic? Use the Search endpoint to find articles that match your query.
Need today's top headlines? Use the Top Headlines endpoint, based on Google News rankings.
The two endpoints
Search endpoint
Finds articles that match your query, with filters for:
- Your query, with exact phrases and the AND, OR, and NOT operators
- Publication date range
- Language and country
Top Headlines endpoint
Returns the top headlines by category, country, and language, based on Google News rankings. The categories are
general, world, nation, business, technology, entertainment, sports, science, and health.
Top Headlines endpoint reference
What your plan includes
Both endpoints are available on every plan. The plan sets how many requests and articles you get, and how far back you can go:
| Plan | Requests per day | Articles per request | Historical data | Data freshness | Full article content |
|---|---|---|---|---|---|
| Free | 100 | 10 | Last 30 days | 12-hour delay | Cut to 250 characters |
| Essential | 1,000 | 25 | Since 2020 | Real-time | Yes |
| Business | 5,000 | 50 | Since 2020 | Real-time | Yes |
| Enterprise | 25,000 | 100 | Since 2020 | Real-time | Yes |
Your plan's historical data sets the range of the from and to parameters: see
Article Availability. Prices and the full comparison are on the
Pricing page.
Next steps
OpenAPI specification
The whole API is described in an OpenAPI 3.1 specification. Import it into Postman or Insomnia, generate a client in your language, or give it to an AI agent as a tool definition.
Support
- GitHub: official libraries and sample projects
- Email: write to our team at contact@gnews.io
- FAQ: answers to common questions
Get your API key
Create a free account to get your API key and send your first request.