Google

Search Google News

Returns current Google News search results. Pages slice the finite result snapshot; they do not traverse the Google Search index. Results include title, source, publisher article URL, age, and thumbnail when available. Valid no-results searches and exhausted pages return an empty array. Locale defaults to country=us and lang=en. Returns 503 for blocked or malformed upstream responses.

get/google/news

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/google/news
  • Auth: API key in header x-api-key

Query parameters

qstring required

Search query

pageinteger

1-based page within the current finite result snapshot; defaults to 1

countinteger

Results per page; defaults to 10, clamped to 1..50

countrystring

Two-letter country code; defaults to us

langstring

Google UI language; defaults to en

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "pagination": {
      "next_page": 2,
      "page": 1,
      "previous_page": 1
    },
    "results": [
      {
        "age": "2 hours ago",
        "description": "OpenAI announced an update.",
        "position": 1,
        "source": "Example News",
        "thumbnail": "https://example.com/thumb.jpg",
        "title": "OpenAI announces update",
        "url": "https://example.com/openai-news"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 3 revisions of this API.