New Ask Claude or ChatGPT about any stock, using Bullpen. Bullpen in Claude or ChatGPT. 7 days free
All pages

People

GET /v1/people

Everyone bullpen.news covers, by name, for the person endpoint. It takes no parameters, and refuses any.

Parameters

None.

curl "https://api.bullpen.news/v1/people" \
  -H "Authorization: Bearer $BULLPEN_KEY"
import os, requests

r = requests.get(
    "https://api.bullpen.news/v1/people",
    headers={"Authorization": f"Bearer {os.environ['BULLPEN_KEY']}"},
)
r.raise_for_status()
print(r.json())
const r = await fetch('https://api.bullpen.news/v1/people', {
	headers: { Authorization: `Bearer ${process.env.BULLPEN_KEY}` }
});
if (!r.ok) throw new Error((await r.json()).detail);
console.log(await r.json());

What comes back

FieldTypeDescription
peoplearray of objectEveryone bullpen.news covers, by name.
people[].slugstringTheir slug on bullpen.news, which person takes.
people[].namestring
people[].linestring or nullWho they are, in one line.
people[].bullpenUrlstringTheir page on bullpen.news.
HeaderSent withDescription
Request-Idevery answerThis request's id, such as req_ followed by 24 letters and digits. Quote it to support.
RateLimit-Policy200, 400, 429, 500, 503Your plan's quotas, per minute and per day (IETF draft-11). It may change to match the RFC.
RateLimit200, 400, 429, 500, 503What each window has left, and the seconds until it resets (IETF draft-11).
WWW-Authenticate401Bearer realm="bullpen.news"
Retry-After429, 503How many seconds to wait.

GET /v1/people

{
  "people": [
    {
      "slug": "warren-buffett",
      "name": "Warren Buffett",
      "line": "Ran Berkshire Hathaway from 1965 to 2025.",
      "bullpenUrl": "https://bullpen.news/people/warren-buffett"
    }
  ]
}

Status codes

StatusMeaningCodes
200The answer.
400A parameter is invalid or unknown (invalid_request), a key is in the URL (key_in_url), or a cursor is not this call's (invalid_cursor).key_in_url, invalid_request, invalid_cursor
401No valid key (unauthorized), or a revoked one (revoked).unauthorized, revoked
403Your account can't use this endpoint now: invite, disabled, terms, no_plan, ended, unpaid or tool.no_plan, ended, unpaid, terms, disabled, invite, tool
429Your plan's minute or day limit is reached (minute, day).minute, day
500Something went wrong on bullpen.news (internal).internal
503The API is paused (off), busy (ceiling) or having trouble (unavailable). Retry-After comes with all but off.ceiling, off, unavailable

Fresh: Up to a minute old.
History: Everyone we cover.
Cost: One call.