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

# Google News

> Get Google News articles by search query — title, source, snippet, published date — with country and language filters

`$4.5 / 1k news`

Get Google News articles by search query — title, source, snippet, published date — with country and language filters

## Endpoint

`POST /api/v1/agents/google/news/run`

## Parameters

<ParamField body="query" type="string" required>
  **Text** · What to search for in Google News.
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Articles per query. Use 0 for all.
</ParamField>

<ParamField body="startDate" type="date">
  **Date picker** · Earliest article date. Leave blank for no lower bound.
</ParamField>

<ParamField body="endDate" type="date">
  **Date picker** · Latest article date. Leave blank for no upper bound.
</ParamField>

<ParamField body="country" type="string">
  **Dropdown** · Filter articles to sources in this country.

  [View all 59 options →](/agents/google/news/values#country)
</ParamField>

<ParamField body="language" type="string">
  **Dropdown** · Filter articles to ones written in this language.

  [View all 35 options →](/agents/google/news/values#language)
</ParamField>

## Response columns

| Field        | Display name | Type   |
| ------------ | ------------ | ------ |
| `articleUrl` | Article URL  | url    |
| `title`      | Title        | text   |
| `snippet`    | Snippet      | text   |
| `publisher`  | Publisher    | text   |
| `domain`     | Domain       | text   |
| `postedAt`   | Posted At    | text   |
| `thumbnail`  | Thumbnail    | url    |
| `position`   | Position     | number |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/google/news/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "maxResults": 100,
      "query": "Elon Musk"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/google/news/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "maxResults": 100,
      "query": "Elon Musk"
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "articleUrl": "https://www.wsj.com/business/autos/elon-musks-tesla-compensation-last-year-surpassed-158-billion-3c84f683",
      "title": "Elon Musk\u2019s Tesla Compensation Last Year Surpassed $158 Billion",
      "snippet": "The world's richest man just got a little richer. Elon Musk's first installment of his moonshot compensation package at Tesla TSLA...",
      "publisher": "WSJ",
      "domain": "www.wsj.com",
      "postedAt": "2026-05-01T11:45:59.326Z",
      "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPDQwMDRsUFRAWIB0iIiAdHx8kKDQsJCYxJx8fLT0tMTU3Ojo6Iys/RD84QzQ5OjcBCgoKDQwNGg8PGjclHyU3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3Nzc3N//AABEIAFwAXAMBIgACEQEDEQH/xAAcAAABBQEBAQAAAAAAAAAAAAAAAgMEBQYBBwj/xAAxEAABAwMCBAMHBAMAAAAAAAABAAIDBAURITEGEiJRE0FhBxQycZGhsRVC4fEkUsH/xAAZAQADAQEBAAAAAAAAAAAAAAAAAQIDBQT/xAAfEQADAAICAwEBAAAAAAAAAAAAAQIDERIhMUFhcSL/2gAMAwEAAhEDEQA/APGIIBLUtp3O5ATq7GUmrpnU1XJDJuw4+Y7p+NodURy7aglSOIQTNBNj42Yz3x/afgqlpl57M7lw/auI45+JYDNRlvSXAuZDJnRzm/uH1xvjt7pxP7SLHZaGJ9vmguM8oHhQ08o5WtI0LiM4HpuV8txu6xnbKfqKl0pwAQOyT+CX09RvftI4iry5sc1PTxO2FPGQQO2SSfoszBf73Uv5GV1UeU5wxz3H7fhZAOc6QGTUL132aspYWispxGJsY8F7e+5z3WVvRvinkQeHrbHcaL9SvFM+WsdMQx1Q5zsNGMYBOMrUyubDSO5QAAPLRXF+gElJHVsaWlrsOHof5WZvEwit8hJx0rx5G3R7McqZPM+J610khha7QvL3fgLOE5Uu5zCaqe9pyD5qGuhC4ykc7JXKmwQhCogmR5DE/Uze820Bx64X5HyOh/4o9O/Oh80iRjoXEH4XJml9pMjtODlTrXAKmsZG/wDcdBnGT2UFw5ThO00xhnZICctOVFLomGlS2WUlHIZ3eE3mDH8rvQrccMt8ceBDK2CraMxuJw1x9VR0zoZmPnhLeU7kO39cfXdTbWGSV0YhnEcnkXbZXkqmzpxKXa9m9i/W2U836pK7qj5Qwy83OWkE8owMads57rLX+70c9E9jJHyRhvX4eMgK04ouVwoLVHUx1cBqaIAyxeHz41GMOwQF5ka1zrZVTnAkqKgnDdANM4HplxWk41T5MyzZOHSKioLDK8xDDM9OeybQhek54Li6hAC2HlKsqdjauAxn4hsqoFSKWYwyBzdwguH6ETRuY8scNWprCt7kxk0TKmPfGqqyNUEtaYqGeSBx8NxGdwPNXVoFVUzsFHBLVHctjaS5vzxsqLHkpllulTZLlFW0hAljOrTs4HcH0KipTLjI5NLf+J2VVhNqmhLqxhDDLzHoa0g4+2FlA/8AwTHnaTP2/hTLnSVNS+W5xUrxSzyOeC3q5c7gqtbkscBtuUSkukF26e2JK4uriozBdXEIAEppSUIAnQTdBY89J/Kchtsk0TpAcNGrfVRqKL3idkROATqta9kMDIYWHGRrlP8ADRf15MaSWOIcNQlOAe3I3U+/0RpqgPaOh6rGnVIhrTLKzVVdBITRTPaW7s3B+YSbhTVUr5at1M4Nc7LnRxEMB/ASrJUinrmOPwydD/mditLe7tWwcOm3NqHGlLifDIBGuCcaabqG9Vo1S3GzDlcQhWYghCEACEIQAuN7o3h7TghaekjNVSslc/JWVVnaqiTnEIcQ3yVx5GnovLoyOqofDc7raMrJEYJBWorm+5Ur5X4L3DpBWXJ5iSfNKvI6exURw/GcZVjW3R1VSOgmZh4dlpB0VYTgoecnPdQ0mJNo4VxCExAhCEACEIQAJ2nmMEzZGjJb5JpCAJ9bcpax2JB0f6hQy3mdhgz2SFMt8hje4gNPT5hNvoqVyeh1lqn8WJs+IWSbSHZM3Kk9zqDCJBIBqHBSmVc9UxsU8hexp0B8kXRjWxt5WgfJXGN1PLY8jmekVSEIWZAIQhAH/9k=",
      "position": 1
    }
  ]
}
```
