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
| Parameters | Required | Description |
|---|---|---|
query | Required | News search, such as a company, product, person or topic. |
location_code | Optional | Location code of the news market. Defaults to 2840 (United States). |
location_name | Optional | Market name as an alternative to location_code. When filled, it is used instead of location_code. |
language_code | Optional | Language code of the news. Defaults to en. |
language | Optional | Language name as an alternative to language_code. When filled, it is used instead of language_code. |
results_limit | Optional | Maximum 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.
- POST {"query": "nvidia", "location_code": 2840, "language_code": "en", "results_limit": 10} to /v1/seo/google-news.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.
- Keyword Suggestions API
- Ranked Keywords API
- Related Keywords API
- Relevant Pages API
- Search Intent API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API