Add to Watchlist
add_to_watchlistFull Description
Add companies to a watchlist
Parameters (2 required)
companyIdsarrayCompany IDs to add
watchlistIdnumberWatchlist ID. Use 0 to follow companies.
Access structured first-party IR data from over 14,500+ public companies across 65 markets. Quartr delivers live and recorded earnings calls, real-time and historical transcripts with speaker identification, slide presentations, filings, reports, and event summaries. Best-in-class reliability and timeliness. Ideal for financial research, investment analysis, and building data-driven workflows on top of institutional-grade public company data.
add_to_watchlistAdd companies to a watchlist
companyIdsarrayCompany IDs to add
watchlistIdnumberWatchlist ID. Use 0 to follow companies.
create_folderCreate a new saved clips folder
namestringFolder name
visibilitystringFolder visibility (default: private)
privateteamcreate_keywordCreate a keyword alert
companySettingstringMonitor all companies or only followed ones
allfollowednamestringThe keyword to monitor
create_search_filterCreate a saved search filter
namestringFilter name
companyIdsarraySpecific company IDs
countriesarrayISO country codes (e.g., "US", "SE")
eventTypesarrayEvent type names in snake_case (e.g., earnings_call)
gicsarrayGICS sector/industry codes (use list_gics to find codes)
marketCapCategoriesarrayMarket cap size filter
create_watchlistCreate a new watchlist
namestringName for the new watchlist
companyIdsarrayCompany IDs to add initially
create_workspaceCreate a new workspace
namestringWorkspace name
visibilitystringWorkspace visibility (default: private)
privateteamdelete_folderDelete a saved clips folder
folderIdnumberFolder ID to delete
delete_keywordDelete a keyword alert
keywordIdnumberKeyword ID to delete
delete_search_filterDelete a saved search filter
filterIdnumberFilter ID to delete
delete_watchlistDelete a watchlist
watchlistIdnumberWatchlist ID to delete (cannot delete followed companies list, id 0)
delete_workspaceDelete a workspace
workspaceIdnumberWorkspace ID to delete
get_companyGet a company's full profile
companyIdnumberCompany ID
get_document_summaryGet a Quartr summary of a document (transcript, report, or slides)
documentIdnumberDocument ID
get_eventGet details for a specific event
eventIdnumberEvent ID
get_event_summaryGet a Quartr summary of an event, covering all attached documents
eventIdnumberEvent ID
get_financialsGet financial statements (income statement, balance sheet, cash flow) for a company
companyIdnumberCompany ID
endDatestringEnd date (ISO 8601, e.g., "2025-01-01"), default today
financialTypestringStatement type filter
incomeStatementbalanceSheetcashFlowStatementperiodTypestringReporting period granularity
quarterlyhalfYearyearlyperiodicalquarterlystartDatestringStart date (ISO 8601, e.g., "2023-01-01"), default 2 years ago
get_watchlistGet a watchlist with its companies
watchlistIdnumberWatchlist ID
list_companiesList companies with optional filters. Results are paginated (default 20 per page). Use page/perPage params to navigate.
countriesarrayISO country codes (e.g., US, SE)
gicsarrayGICS sector or industry name
marketCapsarrayMarket cap size filter
pageintegerPage number (default: 1)
perPageintegerResults per page (default: 20, max: 100)
statusarrayCompany status filter
list_documentsList documents for a company
companyIdnumberCompany ID
documentTypesarrayDocument types to filter by
endDatestringEnd date (ISO 8601, e.g., "2025-01-01")
limitnumberMax results (default 50, max 200)
startDatestringStart date (ISO 8601, e.g., "2024-01-01")
list_event_typesList all event types
list_eventsList events for a company or watchlist. Requires either companyId or watchlistId.
companyIdnumberFilter by company ID
endDatestringReturn events before this date, exclusive (ISO 8601, e.g., "2025-01-01")
eventTypesarrayEvent type names to filter by
limitnumberMax results (default 50, max 200)
orderstringSort order by date (default desc)
ascdescstartDatestringReturn events after this date, exclusive (ISO 8601, e.g., "2024-01-01")
watchlistIdnumberFilter by watchlist ID
list_foldersList the user's saved clips folders
list_gicsList GICS classification hierarchy
list_keywordsList the user's keyword alerts
list_related_companiesFind related companies (peers, competitors)
companyIdnumberCompany ID
list_search_filtersList the user's saved search filters
list_watchlistsList the user's watchlists
list_workspacesList the user's workspaces
visibilitystringFilter by visibility (default: private)
privateteamread_documentRead the full text content of a document (report, slide deck, or transcript)
documentIdnumberDocument ID (slide, report, or transcript)
maxPagesnumberMaximum pages to return (default: all). Use for large documents to limit response size.
read_live_transcriptRead the live transcript for an ongoing or recently completed event. Use this for events that are currently live or have a live transcript available but no finalized transcript yet. Use fromTimestamp to fetch only new content since your last call.
eventIdnumberThe event ID to fetch the live transcript for.
fromTimestampnumberOnly return paragraphs that start after this timestamp (in seconds). Use null or omit to get the full transcript. Use this to fetch new content since your last read.
remove_from_watchlistRemove companies from a watchlist
companyIdsarrayCompany IDs to remove
watchlistIdnumberWatchlist ID. Use 0 to unfollow companies.
rename_folderRename a saved clips folder
folderIdnumberFolder ID to rename
namestringNew folder name
rename_watchlistRename a watchlist
namestringNew name for the watchlist
watchlistIdnumberWatchlist ID (cannot rename followed companies list, id 0)
search_companiesSearch for companies by name or ticker symbol
querystringCompany name or ticker (e.g., "Apple", "AAPL")
search_documentsFull-text search across transcripts, slides, and reports
documentTypesarrayDocument types to search
querystringKeyword search query (max 8 words). Supports: implicit AND, OR, * wildcard, -exclusion, `exact phrase`. Example: "`artificial intelligence` revenue growth"
endDatestringFilter up to this date (ISO 8601: YYYY-MM-DD)
filingTypesarrayFiling type filter (reports only)
filterstringTypesense filter expression. Fields: companyId, eventId, eventTypeId, country, gics.level1-4, marketCapCategory.name. Transcript-only: speechType, speaker.role, speaker.name. Example: country:=[US, SE] && gics.level1:=["Information Technology"]
limitnumberMax results (default 25, max 100)
startDatestringFilter from this date onwards (ISO 8601: YYYY-MM-DD)
tag_company_to_workspaceTag a company to a workspace
companyIdnumberCompany ID to tag
workspaceIdnumberWorkspace ID
untag_company_from_workspaceRemove a company tag from a workspace
tagIdnumberTag ID to remove (returned from tag_company_to_workspace)
workspaceIdnumberWorkspace ID
update_keywordUpdate a keyword alert
companySettingstringMonitor all companies or only followed ones
allfollowedkeywordIdnumberKeyword ID to update
namestringUpdated keyword text