API reference · History
List speakers
GET/v1/history/speakers
Speaker profiles with their settled-market and mention counts.
On this page
Auth. An API token: Authorization: Bearer lb_… (create one). Signed-in web sessions work too.
Limits. One history query per call (500 a day on Free; unlimited on Builder and Standard).
Parameters
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
q | string | no | Free text over the name and aliases. |
limit | integer | no | Page size. 1 to 1000. Default 200. |
Request
curl "https://api.langbot.ai/v1/history/speakers?q=powell" \
-H "Authorization: Bearer $LANGBOT_API_TOKEN"from langbot import LangbotClient
async with LangbotClient() as lb: # reads LANGBOT_API_TOKEN
for s in await lb.speakers("powell"):
print(s.speaker_key, s.display_name)import { LangbotClient } from "@langbotai/sdk";
const lb = new LangbotClient(); // reads LANGBOT_API_TOKEN
const speakers = await lb.speakers("powell");
console.log(speakers);Response
200 OK
{
"count": 1,
"speakers": [
{ "speaker_key": "powell", "display_name": "Jerome Powell", "role": "Chair", "org": "Federal Reserve", "aliases": ["Chair Powell", "Powell"], "profiled": true, "markets": 214, "mentions": 1830, "yes": 51, "no": 160, "void": 3, "yes_rate": 0.242, "last_settled_ts": 1792000000000 }
]
}Errors
| Status | code | When |
|---|---|---|
| 401 | auth_required | No token was sent. |
| 401 | token_invalid | The token was not recognised (mistyped, revoked or expired). |
| 422 | validation_error | A parameter failed validation; detail[].loc names it. |
| 429 | quota_exceeded | Today's history queries are spent; quota.resets_at says when they reset. |
| 429 | rate_limited | Over your request budget; wait Retry-After seconds. |
Every error body is {"detail": …, "code": "…"}; branch on code. All codes: Errors.