# Bullpen.News API

> Stories, X posts, videos, investor letters and the daily recap about US-listed companies, for programs. Read-only JSON over HTTPS at https://api.bullpen.news/v1, with a key, on a paid plan.

For agents:
- The key comes from bullpen.news/account. Read it from the BULLPEN_KEY environment variable and send it as `Authorization: Bearer`.
- Never ask a person to paste a key into chat. On a 401, send them to bullpen.news/account.
- Honour Retry-After on 429 and 503. Switch on the error's `code`.
- Link to each result's `url` when you cite it.

## Guides
- [Overview](https://bullpen.news/docs.md)
- [Quickstart](https://bullpen.news/docs/quickstart.md)
- [Keys](https://bullpen.news/docs/keys.md)
- [Limits](https://bullpen.news/docs/limits.md)
- [Errors](https://bullpen.news/docs/errors.md)
- [Paging](https://bullpen.news/docs/paging.md)
- [Versions and changes](https://bullpen.news/docs/versions.md)

## The data
- [What's in it](https://bullpen.news/docs/data.md)
- [Using the data](https://bullpen.news/docs/using-the-data.md)
- [FAQ](https://bullpen.news/docs/faq.md)

## Reference
- [Endpoints](https://bullpen.news/docs/reference.md)
- [Search companies and letters](https://bullpen.news/docs/reference/search.md)
- [Front page](https://bullpen.news/docs/reference/latest.md)
- [Company](https://bullpen.news/docs/reference/companies.md)
- [Investor letters](https://bullpen.news/docs/reference/letters.md)
- [Daily recap](https://bullpen.news/docs/reference/recap.md)
- [Result detail](https://bullpen.news/docs/reference/items.md)
- [Firms](https://bullpen.news/docs/reference/firms.md)
- [Feed](https://bullpen.news/docs/reference/feed.md)
- [openapi.json](https://api.bullpen.news/openapi.json)
- [Changelog](https://bullpen.news/docs/changelog.md)

## Optional
- [Everything in one file](https://bullpen.news/docs/llms-full.txt)