Piloterr

Google News

GET
/v2/google/news

Extract real-time news articles from Google News with advanced filtering by topic, location, language, and pagination.

Status: Maintenance

Credit cost: 1 credit per call

Autorização

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parâmetros de consulta

query*string

The news search query to execute on Google News. Supports standard Google search operators.

Examples:

  • artificial intelligence: news about AI
  • site:techcrunch.com startup: news from a specific domain
  • "climate change" 2024: exact phrase search

Example:

artificial intelligence news
location?string

City or region from which the news search should originate. Simulates a search performed from the specified location.

Examples:

New York, NY
Paris, France
Tokyo, Japan
uule?string

Google-encoded location string for precise geographic targeting. Use this instead of location when you need exact control.

google_domain?string

Google domain to use for the search. Defaults to google.com.

Examples:

  • google.com
  • google.co.uk
  • google.fr

Example:

google.com
Default"google.com"
gl?string

Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).

Example:

us
Default"us"
hl?string

Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).

Example:

en
Default"en"
cr?string

Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).

Example:

countryUS
lr?string

Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).

Example:

lang_en
page?number

Page number of news results to retrieve.

  • 1: First page (default)
  • 2: Second page, etc.
Default"1"
num?numberDeprecated

Maximum number of results to return per page.

  • 10: Default
  • 40: 40 results
  • 100: 100 results
Default"10"
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Corpo da resposta

Successful response

application/json
  1. response
pagination?
organic_results?array<>
search_parameters?
Example Request
curl -X GET 'https://api.piloterr.com/v2/google/news?query=string'
Example Response
{  "pagination": {    "next": 2,    "current": 1,    "other_pages": [      2,      3,      4,      5,      6,      7,      8,      9,      10    ],    "has_next_page": true  },  "organic_results": [    {      "date": "3 hours ago",      "link": "https://www.theguardian.com/technology/2026/mar/27/number-of-ai-chatbots-ignoring-human-instructions-increasing-study-says",      "title": "Number of AI chatbots ignoring human instructions increasing, study says",      "domain": "www.theguardian.com",      "source": "The Guardian",      "snippet": "Exclusive: Research finds sharp rise in models evading safeguards and destroying emails without permission.",      "position": 1,      "displayed_link": "www.theguardian.com",      "snippet_matched": []    },    {      "date": "20 hours ago",      "link": "https://www.bloomberg.com/news/articles/2026-03-26/apple-plans-to-open-up-siri-to-rival-ai-assistants-beyond-chatgpt-in-ios-27",      "title": "Apple Plans to Open Up Siri to Rival AI Assistants in iOS 27 Update",      "domain": "www.bloomberg.com",      "source": "Bloomberg.com",      "snippet": "Apple Inc. plans to open Siri to outside artificial intelligence assistants, a major move aimed at bolstering the iPhone as an AI platform.",      "position": 2,      "displayed_link": "www.bloomberg.com",      "snippet_matched": [        "intelligence",        "artificial"      ]    },    {      "date": "1 hour ago",      "link": "https://www.cnbc.com/2026/03/27/anthropic-cybersecurity-stocks-ai-mythos.html",      "title": "Cybersecurity stocks fall on report Anthropic is testing a powerful new model",      "domain": "www.cnbc.com",      "source": "CNBC",      "snippet": "The cybersecurity sector has slumped this year on fears that new AI will massively disrupt their business models.",      "position": 3,      "displayed_link": "www.cnbc.com",      "snippet_matched": []    }  ],  "search_parameters": {    "q": "artificial intelligence news",    "gl": "us",    "hl": "en",    "num": 10,    "page": 1,    "uule": null,    "engine": "google_news",    "location": null  }}

Google Maps GET

Anterior

Google Search GET

Próximo