Find summaries

Find summaries based on filter criteria

GET /summaries

Parameter	Type	DataType	Description
event_type	query	string	Filter by: earnings, presentation, investor_meeting, special_situation
start_date	query	datetime	Fetch summaries on or after this date (defaults to 2 weeks ago)
end_date	query	datetime	Fetch summaries on or before this date (defaults to 2 weeks from now)
bloomberg_ticker	query	string	Filter to one or more Bloomberg tickers (comma-separated)
isin	query	string	Filter to one or more ISIN identifiers (comma-separated)
ric	query	string	Filter to one or more RIC identifiers (comma-separated)
permid	query	string	Filter to one or more PermID identifiers (comma-separated)
summary_type	query	string	Which type of summary do you want (zeroshot, criticals)
version	query	string	Which version of summary do you want (live, published, all)
from_index	query	integer	The index from which to start returning summaries
size	query	integer	The number of summaries to return (default: 20, max: 100)

Response

[
  {
    "event": {
      "event_id": 2036758,
      "equity_id": 1,
      "local_ticker": "AMZN",
      "bloomberg_ticker": "AMZN:US",
      "ric": "AMZN.OQ",
      "permid": "4295905494",
      "isin": "US0231351067",
      "exchange_mic": "XNAS",
      "title": "Q4 2021 Amazon.com Inc Earnings Call",
      "event_type": "earnings",
      "event_date": "2022-02-03T17:30:00",
      "has_unknown_time": false,
      "connection_expected": true,
      "conference_number": null,
      "conference_pin": null,
      "broadcast_url": "https://event.webcasts.com/starthere.jsp?ei=1523078&tp_key=e06eadc9c9",
      "replay_url": "https://bit.ly/3YWURdM",
      "slides_url": "https://a.aiera.com/api/events/2036758/assets/press_url",
      "press_url": "https://a.aiera.com/api/events/2036758/assets/press_url",
      "public_url": "https://dashboard.aiera.com/p/evtmin/e317fe100f9b05420f2a875523852fa5",
      "transcription_status": "active",
      "transcription_audio_url": null,
      "transcription_audio_offset_seconds": 238,
      "has_transcripts": true,
      "has_pricing": true,
      "status": "active",
      "created": "2022-01-21T02:01:28",
      "modified": "2022-02-04T03:21:37"
    },
    "summary": {
      "title": "Amazon Q4 Financial Results: Strong Growth, Prime Memberships, and Price Increase",
      "summary": [
        "Brian Olsavsky, CFO of Amazon, discussed the company's fourth quarter financial results during a conference call. Net sales increased 10% year-over-year, excluding foreign exchange impacts. Prime memberships saw strong growth and 3P sellers provided 56% of all unit sales in Q4. AWS saw continued strong usage and revenue growth, growing 40% year-over-year. Operating income was $3.5 billion and net income was $14.4 billion, including a pretax valuation gain of $11.8 billion related to their investment in Rivian Automotive. They are now separating advertising services revenue from other as part of their revenue disclosures.",
        "Amazon announced that they will be increasing the useful life of their servers and networking equipment, resulting in an approximate $1 billion decrease in depreciation expense. They will also be increasing the price of Prime membership in the U.S., with the monthly price going from $12.99 to $14.99 and the annual membership going from $119 to $139. According to Amazon, this is their first price increase since 2018."
      ],
      "model": "zeroshot",
      "type": "presentation",
      "version": "published",
      "audio_clip": "https://audio.aiera.com/api/summaries/2036758/zeroshot/audio",
      "video_clip": null,
      "priority": 2
    }
  }
]

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/summaries' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/summaries", headers={"X-API-Key": "xxx"})