# Quickstart

The baba News API returns the Israeli press as structured JSON: clustered events, which newsrooms filed and which did not, the left, centre and right split, Hebrew reporting translated to English, running threads, newsroom profiles, search, the daily brief, and named people.

Everything is `GET` over HTTPS, every response is JSON, and every request carries one header.

## Get a key

Open the [console](/developers/console), create your organization with a name and a work email, and press **Create key**. The key is shown once. Every new organization starts on a 14 day trial of Starter.

## Your first request

```bash Request
export BABA_NEWS_API_KEY='nk_live_...'

curl --get 'https://news.itsbaba.com/api/v1/stories' \
  --header "Authorization: Bearer $BABA_NEWS_API_KEY" \
  --data-urlencode 'lang=en' \
  --data-urlencode 'limit=5'
```

## What comes back

Every list endpoint returns the same envelope. `data` holds the records, `nextCursor` is the token for the following page and is `null` on the last one, and `generatedAt` is when the page was computed.

```json Response envelope
{
  "data": [ /* stories */ ],
  "nextCursor": "MjAyNi0wOS0wMVQwODowMDowMC4wMDBafDQ0",
  "lang": "en",
  "generatedAt": "2026-09-04T12:00:00.000Z",
  "limit": 40
}
```

## The base URL

`https://news.itsbaba.com` in every environment. There is no sandbox host: a trial key reads the same live wire as a paid one, with a smaller quota.

## Where to go next

- [Authentication](/developers/docs/authentication) — the header, the key format, and what a rejection looks like.
- [Scopes and plans](/developers/docs/scopes) — which endpoints a key can reach.
- [Endpoint reference](/developers/docs/endpoints) — every path, parameter and response.
- [Agent skill](/developers/docs/agent-skill) — a downloadable bundle that teaches a coding agent this API.