seo/
google-news

The Google News API collects Google News articles for a company, product or topic in any market, with headline, snippet, publisher, publish time, thumbnail and a direct link to the publisher's own page.

Google News API

Top stories first
Direct publisher links
Publish time
Any country and language
0.1 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Google News

Google News collects coverage from news publishers and ranks it for each search, putting a top stories carousel above the wider list of articles, with every result showing a headline, a snippet, the outlet and when it was published. Following those results for a company, a product or a topic shows who is writing about it, how quickly a story spreads across outlets and how coverage differs between countries, which is the raw material of media monitoring, competitor alerts and daily news digests.

Google News API Features

  • Links straight to the articleurl points to the article on the publisher's own site, ready to open, archive or pass to a reader without following a Google link.
  • Top stories kept apartsection marks each article as top_stories or news, and rank keeps Google's order with the top stories carousel first.
  • Publisher and publish time on every articlesource names the outlet, domain gives its site and published_at records when the article went out, for sorting and filtering coverage.
  • Headline, snippet and thumbnailtitle and text carry the headline and the snippet shown under it, and image_url gives the article thumbnail when it is public.
  • Any market, up to 200 articlesPick the country and language of the search and set results_limit from 1 to 200 articles per request.

Google News API Parameters

ParametersRequiredDescription
queryRequiredNews search, such as a company, product, person or topic.
location_codeOptionalLocation code of the news market. Defaults to 2840 (United States).
location_nameOptionalMarket name as an alternative to location_code. When filled, it is used instead of location_code.
language_codeOptionalLanguage code of the news. Defaults to en.
languageOptionalLanguage name as an alternative to language_code. When filled, it is used instead of language_code.
results_limitOptionalMaximum number of articles, from 1 to 200. Defaults to 10.

How to Use the Google News API

Send a search query to the Google News API and read one row per article.

  1. POST {"query": "nvidia", "location_code": 2840, "language_code": "en", "results_limit": 10} to /v1/seo/google-news.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read articles from results.items in rank order, and request the next page with results.next_cursor while has_more is true.
curl -X POST "https://api.socq.ai/v1/seo/google-news" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"nvidia","location_code":2840,"language_code":"en","results_limit":10}'

Google News API Use Cases

  • Monitor press coverage of your brand: Run your brand name through the Google News API on a schedule, keep the url of each article you have seen, and alert on new ones with their source and published_at.
  • Watch competitors' launches and announcements: Query each competitor's name and product lines to see which outlets pick up their news and how fast.
  • Build a daily news digest: Collect top_stories for a set of industry topics each morning and send headline, snippet and link to a team channel or newsletter.
  • Compare coverage across countries: Run the same query in several markets to see which stories travel and which stay local.

Google News API Pro Tips

  • If you only need the headline stories, filter on section top_stories rather than raising results_limit.
  • When you deduplicate Google News API results across runs, key on url, since it is the article's own address and also serves as the row id.
  • If a name is ambiguous, add a qualifier to query, such as the company's industry or product, so unrelated stories drop out.

Beyond the Google News API, use these APIs when you need a different type of public SEO data.

  • Google Organic SERP API — Retrieve one live Google result page by query and market with normalized destinations, ranks, element types, and full result details.
  • Keyword Difficulty API — Compare organic ranking difficulty for a submitted keyword batch, returning each available keyword with its normalized score.
  • Keyword Overview API — Enrich a submitted keyword batch with available demand, paid competition, difficulty, monthly-search, and intent context.
  • Keyword Search Volume API — Measure known keywords with available search volume, CPC, paid competition, and monthly search history.
  • Keywords for Site API — Generate keywords relevant to one website with available demand measurements, monthly history, market context, and complete source rows.
  • Google Autocomplete API — Collect the search completions Google suggests for the start of a query, in Google's order, for any country and language.

Explore other platforms

Combine SEO data with public data from other supported social platforms.

Google News API — FAQ

Google News API returns Google News articles for a search in the chosen country and language, each with headline, snippet, publisher, domain, publish time, thumbnail and a direct link to the article.

url points to the article on the publisher's own site, so it can be opened or stored directly.

section tells where Google showed the article: top_stories for the top stories carousel or news for the main list. Top stories come first in rank.

results_limit accepts 1 to 200 and defaults to 10.

Each article returned costs 0.1 credits.