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

Person

GET /v1/people/{slug}

A person we cover, such as Warren Buffett, by their slug or name: their videos with our summaries, or, given a query, short passages of what they said, each with the second it starts. Any other parameter is refused.

Parameters

ParameterTypeDescription
slugstring, in the path, 1 to 100 characters, requiredA person we cover, by their slug or their name, such as warren-buffett or Warren Buffett. Spaces at either end don't count, and it can't contain a null character.
querystring, 1 to 200 charactersWords they said, such as float or "share buybacks": quotes keep a phrase together. Leave it out for their videos, newest first. Spaces at either end don't count, and it can't contain a null character. A query with no word to look for is refused.
whostringWhose words query searches: person (the default) for the person's own, everyone for anyone in their videos. Only with query. It must come with query. One of person or everyone.
limitinteger, 1 to 10, default 10How many videos to return, from 1 to 10.
cursorstringThe nextCursor a previous call returned, for the next page. Keep the other arguments the same.
curl "https://api.bullpen.news/v1/people/warren-buffett?query=float&limit=1" \
  -H "Authorization: Bearer $BULLPEN_KEY"
import os, requests

r = requests.get(
    "https://api.bullpen.news/v1/people/warren-buffett",
    params={"query": "float", "limit": 1},
    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/warren-buffett?query=float&limit=1', {
	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
personobject
person.slugstringTheir slug on bullpen.news, which person takes.
person.namestring
person.linestring or nullWho they are, in one line.
person.bullpenUrlstringTheir page on bullpen.news.
videosarray of objectNewest first. With query, the videos with the most passages first.
videos[].idstringIts id, such as video:789.
videos[].kindvideo
videos[].urlstringThe video on YouTube.
videos[].publishedstring (date-time)When it was published, in UTC.
videos[].wentLivestring (date-time) or nullWhen it went live on bullpen.news, in UTC.
videos[].companiesarray of stringThe companies it is about, by ticker. tickers says what each one is.
videos[].summarystringOur summary of what is said in it, from our own transcript. Only with bullpenUrl.
videos[].peoplearray of objectThe people we cover who are in it. Left out when none.
videos[].people[].slugstringThe person's slug on bullpen.news.
videos[].people[].namestring
videos[].bullpenUrlstringIts page on bullpen.news, with what was said in it. Only on a video of a person we cover, once its page is ready.
videos[].passagesarray of PassageWith query: up to 3 short passages that hold it, in time order. Empty when only our summary matches.
tickersmap of TickerEntryEach company the results name, by ticker.
nextCursorstringPass it as cursor for the next page. Left out on the last page.
HeaderSent withDescription
Request-Idevery answerThis request's id, such as req_ followed by 24 letters and digits. Quote it to support.
RateLimit-Policy200, 400, 404, 429, 500, 503Your plan's quotas, per minute and per day (IETF draft-11). It may change to match the RFC.
RateLimit200, 400, 404, 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/warren-buffett?query=float&limit=1

{
  "person": {
    "slug": "warren-buffett",
    "name": "Warren Buffett",
    "line": "Ran Berkshire Hathaway from 1965 to 2025.",
    "bullpenUrl": "https://bullpen.news/people/warren-buffett"
  },
  "videos": [
    {
      "id": "video:7186332",
      "kind": "video",
      "url": "https://www.youtube.com/watch?v=x2xUC9gWy3Q",
      "published": "2020-11-03T22:00:14Z",
      "wentLive": "2026-11-18T05:40:44Z",
      "companies": [
        "BRK.A"
      ],
      "summary": "Warren Buffett and Charlie Munger answer shareholder questions at Berkshire Hathaway’s 2001 annual meeting. They return repeatedly to buying durable businesses, deploying insurance float, GEICO and General Re underwriting, and Berkshire’s limits as it grows. They also discuss technology, accounting for options and pensions, derivatives, corporate acquisition practices, utilities, succession, and the risks hidden in leveraged financial institutions.",
      "people": [
        {
          "slug": "warren-buffett",
          "name": "Warren Buffett"
        }
      ],
      "bullpenUrl": "https://bullpen.news/people/warren-buffett/2001-annual-meeting",
      "passages": [
        {
          "text": "And then we have the use of float for many years to come and there are no subsequent charges against that. So in respect to those contracts, the important thing is that we tell you, and we should tell you really every quarter, if they’re significant and certainly yearly, any significant items that fall in that category.",
          "start": 1115,
          "url": "https://www.youtube.com/watch?v=x2xUC9gWy3Q&t=1115",
          "bullpenUrl": "https://bullpen.news/people/warren-buffett/2001-annual-meeting?t=1115"
        },
        {
          "text": "And therefore our cost of float, if we hadn’t willingly engaged in those transactions, would have been about 4.5%. I should mention to you that I expect that our cost of float, I said in the annual report that absent a mega catastrophe, and I might define a mega catastrophe as insured losses, we’ll say of 20 billion or more…",
          "start": 1216,
          "url": "https://www.youtube.com/watch?v=x2xUC9gWy3Q&t=1216",
          "bullpenUrl": "https://bullpen.news/people/warren-buffett/2001-annual-meeting?t=1216"
        },
        {
          "text": "I should mention to you that I expect that our cost of float, I said in the annual report that absent a mega catastrophe, and I might define a mega catastrophe as insured losses, we’ll say of 20 billion or more or something on that order. Absent a mega catastrophe, we expected our cost of float to come down this…",
          "start": 1224,
          "url": "https://www.youtube.com/watch?v=x2xUC9gWy3Q&t=1224",
          "bullpenUrl": "https://bullpen.news/people/warren-buffett/2001-annual-meeting?t=1224"
        }
      ]
    }
  ],
  "tickers": {
    "BRK.A": {
      "name": "Berkshire Hathaway INC",
      "sector": "Financials",
      "marketCapUsd": 1257063710000,
      "bullpenUrl": "https://bullpen.news/ticker/BRK.A"
    }
  },
  "nextCursor": "WyJwZXJzb24iLCJ2aWRlb3MiLCI5VEswcU1zenRxVzkzMnh6IiwxXQ"
}

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
404Nothing by that ticker, firm, id, day or person (not_found).not_found
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: A video arrives once its page is ready. Up to a minute old.
History: Every video of theirs with a page.
Cost: One call.