Skip to the page

GNews compatible

Change the address, keep the JSON.

GNews sells a daily cap: Essential is €49.99 a month for 1,000 requests per day, and the API returns 403 until 00:00 UTC once it is used. SpecStream answers the same /api/v4/search in GNews's JSON, at $0.005 a call.

The switch is one line: https://api.specstream.ai in place of https://gnews.io, and a SpecStream key as apikey. The paths, the parameters and your parser stay.

SpecStream scores 97.9 F-score on all 1,000 SimpleQA Verified questions. A new account gets $10 of credit, no card, which covers 2,000 news searches.

New accounts get $10 of credit, no card. It covers 2,000 searches.

GNews to SpecStream, parameter by parameter and field by field

SpecStreamGNews
AddressGET https://api.specstream.ai/api/v4/search and /api/v4/top-headlinesGET https://gnews.io/api/v4/search and /api/v4/top-headlines
The keyA SpecStream key as apikey in the address, or in the X-Api-Key headerA GNews key as apikey in the address
Articles a callmax up to 100 on every account, with page for the next pageUp to 10 on Free, 25 on Essential, 50 on Business, 100 on Enterprise
Freshnessfrom and to set the window, and the newest articles come firstThe free plan covers the last 30 days with a 12-hour delay
Each articletitle, description, url, publishedAt and source.name. content and image come back as nullid, title, description, content, url, image, publishedAt, lang and source
Limits and errorsGNews's {"errors": [...]} form: 401 for a key that is not one. Up to 26,666 searches a minute; a busy call gets 429 with Retry-After and is not charged429 over 1 request a second on Free and 10 on paid plans. 403 once the day's quota is used, until 00:00 UTC
Price$0.005 a call of up to 10 articles, $5 per 1,000, with no plan. Each started block of 10 more adds $0.006Essential €49.99 a month for 1,000 requests per day. Business €99.99 for 5,000 per day
Free to start$10 of credit, no card, usable in production100 requests per day, up to 10 articles, for non-commercial projects

The GNews reference, on SpecStream

What else GNews users price

How SpecStream scores

The same numbers as the benchmarks page, from the official tasks and scorers.

How to migrate, step by step

1. Create a key under Agents & API in the workspace. A new account gets $10 of credit, no card, which covers 2,000 news searches.

2. Set the address to https://api.specstream.ai/api/v4 where your code has https://gnews.io/api/v4, and send the SpecStream key as apikey. In Python:

import requests

URL = "https://api.specstream.ai/api/v4/search"  # was https://gnews.io/api/v4/search

reply = requests.get(URL, {"apikey": SPECSTREAM_KEY, "q": "Nvidia earnings", "lang": "en", "max": 10}, timeout=30)
reply.raise_for_status()
for article in reply.json()["articles"]:
    print(article["publishedAt"], article["source"]["name"], article["title"], article["url"])

3. In JavaScript:

const url = new URL("https://api.specstream.ai/api/v4/top-headlines");
url.search = new URLSearchParams({ apikey: process.env.SPECSTREAM_KEY, category: "business", lang: "en" });
const data = await (await fetch(url)).json();
for (const article of data.articles) console.log(article.publishedAt, article.title, article.url);

4. Read 429 as a call to send again after Retry-After. It is not charged.

Frequently asked questions

Something we didn't answer? Talk to a human

Is there a GNews compatible API?
Yes. SpecStream answers GNews's GET /api/v4/search and /api/v4/top-headlines at https://api.specstream.ai in GNews's JSON, as measured on production on Nov 10, 2026. A call of up to 10 articles costs $0.005.
How do I migrate from GNews?
Change one address: https://gnews.io becomes https://api.specstream.ai, and a SpecStream key goes in apikey. q, lang, max, page, from, to, sortby=publishedAt and category keep their meaning.
How much does GNews cost?
€49.99 a month for Essential with 1,000 requests per day, €99.99 for Business with 5,000 per day, and a free plan of 100 requests per day for non-commercial projects. SpecStream costs $5 per 1,000 calls with no plan.
Does the GNews Python client work with SpecStream?
Yes. gnews-io-python 1.0.0 works with base_url="https://api.specstream.ai/api/v4" and a SpecStream key, as tested on production on Nov 10, 2026. Search and top headlines run unchanged.
What happens when I reach the GNews daily quota?
GNews returns 403 until the quota resets at 00:00 UTC. SpecStream has no daily quota: one account sends up to 26,666 searches a minute, from a balance.
Which GNews fields does SpecStream not fill?
content and image come back as null, and id, lang, source.id, source.url and source.country are not returned. Each article keeps title, description, url, publishedAt and source.name.

Sources

SpecStream wrote this page. Each GNews figure comes from GNews's own pages, and each other provider's figure from that company's own page. The route's behavior comes from its code and the pass table measured on production.

  1. GNews pricinggnews.io/pricing, read Nov 10, 2026
  2. GNews search endpointdocs.gnews.io/endpoints/search-endpoint, read Nov 10, 2026
  3. GNews error handlingdocs.gnews.io/error-handling, read Nov 10, 2026
  4. GNews JSON responsedocs.gnews.io/json-response, read Nov 10, 2026
  5. SpecStream GNews pass tablespecstream.ai/specstream/dialects/gnews.md, read Nov 10, 2026
  6. SerpApi pricingserpapi.com/pricing.md, read Nov 10, 2026
  7. Serperserper.dev/, read Nov 10, 2026
  8. SpecStream benchmarksspecstream.ai/benchmarks, read Nov 10, 2026
  9. SpecStream pricingspecstream.ai/pricing, read Nov 10, 2026
  10. SpecStream for agentsspecstream.ai/agents.md, read Nov 10, 2026