Resolve an entity
scope=all adds commodities, FX pairs, people, conflicts
and organisations and includes national/regional macro series with stable IDs.
country=AE narrows macro series to a country and its regions. limit is per
group, bounded to 1–20.
Use the returned company cik, including a letter-prefixed platform key, for
subsequent requests. A ticker alone can collide across markets. An empty bucket
does not prove that an entity never existed; covered/published inventory bounds
the response, and a search bucket may fail independently.
The CLI’s formatted search command remains curated. For full programmatic scope:
search requests the programmatic scope and returns exact identifiers.
Search source passages
GET /api/v1/transcripts/search supports websearch expressions: quoted phrases,
OR, and -exclusion. Filter by company or basket, dates, speaker/role, section,
topic or explicit lexical theme. sort=relevance ranks matches; the default is
newest first. includeContext=1 requests surrounding speaker turns or exchanges.
Use the returned cursor to continue the same query.
Passages retain issuer, speaker, call date and character spans. Retrieve context
before quoting. Theme expansion is lexical matching, not an inferred semantic
claim. /summary, /facets and /topics provide counts, filter options and
inspectable topic comparisons; these have coverage and result-cap caveats.
Use search_transcripts, analyze_transcript_topics or get_mentioned_by over
MCP, or astreus transcript-search and astreus mentioned-by in the CLI.