Piloterr

Google News

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

Credit cost: 1 credit per call

GET
/v2/google/news

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

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.

gl?string

Two-letter country code for the Google News country context.

  • us: United States
  • fr: France
  • gb: United Kingdom
  • de: Germany

Example:

us
Default"us"
hl?string

Two-letter language code for the Google News language context.

  • en: English
  • fr: French
  • de: German
  • es: Spanish

Example:

en
Default"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"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/google/news?query=string"

{
  "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
  }
}

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}