Skip to main content
GET
How many quotes, passages, people, shows and companies one search finds, each counted as its own list

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer pd_live_…. Someone on your team makes one in the workspace, Settings › API keys; it's shown once. Staging's keys start with pd_test_.

Query Parameters

person
string
Maximum string length: 120
company
string

The speaker's company: by our id (microsoft) or name, any case, the company the quote gives its speaker on the day (speaker.company), or the directory's company for the speaker

Maximum string length: 120
show
string
Maximum string length: 120
named
string

A company or person the quote names, by id (openai, sam-altman) or by name

Maximum string length: 120
ticker
string

A ticker: quotes said by people at a company listed under it, or naming one, or one it owns

Maximum string length: 12
claim
enum<string>

Only quotes making this kind of claim

Available options:
forecast,
commitment,
admission,
figure,
none
kind
enum<string>

The speaker's kind, in the words GET /people uses. A quote whose speaker isn't in the directory has none

Available options:
founder,
ceo,
executive,
researcher,
investor,
official,
central_banker,
head_of_state,
host,
reporter
from
string<date>
to
string<date>
confirmed
boolean
default:true

true: only quotes whose speaker is confirmed. false: unconfirmed speakers too, marked so

events
enum<string>
default:include

Quotes from companies' own official events: include them (the default), leave them out, or only them

Available options:
include,
exclude,
only
list
string

A team's list (lst_…): quotes said by someone on it or by someone at a company on it. Another team's list, or a deleted one, is a 404

Maximum string length: 64
q
string
required

The box's words, as GET /quotes takes them: words in quotation marks match exactly, the rest by meaning

Required string length: 1 - 300
listed
boolean

For the companies count: true, only companies on a stock exchange; false, only those that are not

Response

The five counts, and the passages by place

q
string
required
quotes
object
required
passages
object
required
in
object
required

Each place GET /passages looks, counted as GET /passages?in= lists it: documents (filings and releases), slides (decks), transcripts (call transcripts) and articles (news). passages stays filings, releases and decks together, as GET /passages lists by default

people
object
required
shows
object
required
companies
object
required
waiting
string | null
required

Why a count is null: on Free, past the day’s model cap, quotes by meaning wait until midnight UTC