> ## 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.

# Getting started

> Create an account, generate an API key, and make your first request to a Bonai API

This guide walks you through everything you need to start calling Bonai APIs. You set up your account once. After that, you create a separate API key for each product you want to use.

## 1. Create your account

Go to the [Bonai console](https://console.bonai.io) and sign up with your email or Google account. You'll need to verify your email address before you can continue.

## 2. Select a product

Each Bonai product has its own workspace. Use the product switcher in the sidebar to select the product you want to use, for example **Bonai News API** or **Google News API**.

## 3. Create an API key

1. In your product workspace, open **API Keys**.
2. Click **Create key** and give it a name, for example `production` or `staging`.
3. Copy the full key (`bk_...`). It is shown only once.

API keys are scoped to a product. A key created in the **Bonai News API** workspace only works with the Bonai News API.

<Warning>
  Store your API key somewhere safe. You cannot view the full key again after closing the dialog. If you lose it, revoke the key and create a new one.
</Warning>

## 4. Make your first request

Send your key with every request using the `api-key` header:

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

A successful response looks like this:

```json theme={null}
{
  "success": true,
  "size": 10,
  "totalHits": 12843,
  "hitsPerPage": 10,
  "page": 1,
  "totalPages": 1285,
  "timeMs": 42,
  "data": []
}
```

## What's next

* Learn about [authentication](/news-api/authentication) in detail.
* Read the [Bonai News API quickstart](/news-api/quickstart) or the [Google News API quickstart](/google-news-api/quickstart).
* Browse every endpoint in the interactive API Reference for the [Bonai News API](/openapi/bonai-news-api.json) and the [Google News API](/openapi/google-news-api.json).