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

# Quickstart

> Make your first request to the Google News API

This guide gets you from zero to your first Google News API request. You'll need an API key from the [Bonai console](https://console.bonai.io). See [getting started](/getting-started) if you don't have one yet.

## Search for news

The `GET /search` endpoint returns search results with clustering:

```bash theme={null}
curl --request GET \
  --url "https://api.bonai.io/google-news/search?query=technology" \
  --header "api-key: YOUR_API_KEY"
```

The response uses the standard envelope:

```json theme={null}
{
  "metadata": {
    "id": "c1a2b3d4-e5f6-4789-8abc-def012345678",
    "total_hits": 842,
    "took_ms": 96,
    "timestamp": "2026-07-30T09:00:00Z"
  },
  "parameters": {
    "query": "technology",
    "country": "us",
    "language": "en"
  },
  "news_articles": [
    {
      "type": "article",
      "title": "Example technology headline",
      "url": "https://example.com/story",
      "date": "2026-07-30T08:00:00Z",
      "image": "https://example.com/image.jpg",
      "source": {
        "name": "Example Publishing",
        "url": "https://example.com",
        "favicon": "https://example.com/favicon.ico",
        "publication_id": "CAAq..."
      },
      "authors": ["Jane Doe"]
    }
  ]
}
```

## Get news by topic

```bash theme={null}
curl --request GET \
  --url "https://api.bonai.io/google-news/topics?topic_id=TECHNOLOGY&country=us&language=en" \
  --header "api-key: YOUR_API_KEY"
```

Pass a `CAAq...` ID as `topic_id` to target a specific topic or subtopic.

## Get the frontpage

```bash theme={null}
curl --request GET \
  --url "https://api.bonai.io/google-news/frontpage?country=us&language=en" \
  --header "api-key: YOUR_API_KEY"
```

## Full coverage of a story

```bash theme={null}
curl --request GET \
  --url "https://api.bonai.io/google-news/stories?story_id=STORY_ID&country=us&language=en" \
  --header "api-key: YOUR_API_KEY"
```

## Next steps

* Explore all endpoints in the [API Reference](/openapi/google-news-api.json).
* Understand [API versions](/google-news-api/api-version), [rate limits](/google-news-api/rate-limits), and [errors](/google-news-api/errors).