> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google News

> Find recent news articles for a person, company, event, or keywords.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="query" type="string" required>
  The news query a person, company, event, or keywords.
</ParamField>

<ParamField body="country" type="string">
  Country code for localized results (gl param), e.g. `us`.
</ParamField>

<ParamField body="lang" type="string">
  Language code (hl param), e.g. `en`.
</ParamField>

## Response

Returns the standard Google lookup shape with the `news` array populated.

<ResponseField name="news" type="object[]">Articles with `title`, `link`, `date`, `source`, and `imageUrl`.</ResponseField>

<ResponseExample>
  ```json theme={"dark"}
  {
    "query": "OpenAI",
    "type": "news",
    "credits": 1,
    "news": [
      {
        "title": "OpenAI announces new model",
        "link": "https://example.com/article",
        "date": "2 hours ago",
        "source": "TechCrunch",
        "imageUrl": "https://example.com/image.jpg"
      }
    ]
  }
  ```
</ResponseExample>

## Credits

1 credit per lookup.