Skip to main content
GET
Transcript topic analysis

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Astreus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Query Parameters

topicColumns
string

JSON array of 1–12 ordered columns: id, label, terms, exclude, match (any/all). Each phrase is literal text; exclusions apply across all alternatives. Definitions must fit a 6,000-character URL-encoded budget.

column
string

Apply a column from topicColumns (or the default set) to source passages.

q2
string

Second websearch expression; combined with q in the same speaker passage.

termMatch
enum<string>
default:all

Combine q and q2 using all (AND) or any (OR).

Available options:
all,
any
topic
enum<string>

Inspectable lexical research topic.

Available options:
demand,
pricing,
margins,
investment,
ai,
credit,
funding,
regulation,
returns,
outlook
browse
string

1 = browse source turns without a keyword predicate.

region
string

Issuer region from the country catalog.

subregion
string

Issuer subregion from the country catalog.

city
string

Exact city in the company's currently stored business address; missing addresses remain unknown.

locationMode
enum<string>
default:inside

Inside or outside the intersection of selected country/region/subregion/city.

Available options:
inside,
outside
includeUnknownLocation
string

1 = include unknown geography in outside searches; excluded by default.

q
string

Primary websearch expression.

mentioned
string

Company being named.

theme
string

Lexical theme.

country
string

Issuer ISO alpha-2 country or unknown.

company
string

Speaking company.

companies
string

Company basket, up to 20 identifiers.

role
string

Speaker role.

section
string

Call section.

speaker
string

Speaker name contains.

from
string

Current comparison window start, YYYY-MM-DD.

to
string

Current comparison window end, YYYY-MM-DD.

includeSelf
string

1 includes subject's own calls.

Response

OK

The response is of type object.