# Quickstart

Your first request in two minutes.

## 1. Make a key

Start a free trial, then make a key on your [account page](/account). It's shown once, so put it in an environment variable:

```sh
export BULLPEN_KEY=bullpen_…
```

## 2. Make a request

Ask for everything on one company. Every request sends the key in the `Authorization` header.

```sh
curl "https://api.bullpen.news/v1/companies/NVDA?limit=3" \
  -H "Authorization: Bearer $BULLPEN_KEY"
```

```python
import os, requests

r = requests.get(
    "https://api.bullpen.news/v1/companies/NVDA",
    params={"limit": 3},
    headers={"Authorization": f"Bearer {os.environ['BULLPEN_KEY']}"},
)
r.raise_for_status()
print(r.json()["company"]["name"])
```

```js
const r = await fetch('https://api.bullpen.news/v1/companies/NVDA?limit=3', {
	headers: { Authorization: `Bearer ${process.env.BULLPEN_KEY}` }
});
if (!r.ok) throw new Error((await r.json()).detail);
const { company } = await r.json();
console.log(company.name);
```

## 3. Read the answer

- `company`: its name, sector, market cap and how often we've covered it.
- `stories`, `xPosts`, `letters`: its newest results, each with a link to the original.
- `tickers`: every company the results mention, named once.
- `nextCursors`: pass one back as `cursor` for that list's next page.

Each result has `published`, the publisher's time, and `wentLive`, when it went live on Bullpen.News.

## Next

- [Limits](/docs/limits): 30 calls a minute on Individual, 600 on Corporate, shared with your AI apps.
- [Errors](/docs/errors): one shape, a code for each case, and what to do.
- [What's in it](/docs/data): sources, how fresh, how far back.
- [Using the data](/docs/using-the-data): what you may do with it.