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)

Request

https://premium.aiera.com/api/summaries?start_date=2024-1-01&end_date=2024-11-06&bloomberg_ticker=AMZN:US&size=2

Response

[
  {
    "event": {
      "event_id": 2652890,
      "equity_id": 1,
      "local_ticker": "AMZN",
      "bloomberg_ticker": "AMZN:US",
      "ric": "AMZN.OQ",
      "isin": "US0231351067",
      "permid": "4295905494",
      "exchange_mic": "XNAS",
      "title": "ASR CLI Test: 2024-11-06T23:42:26.805167",
      "event_type": "custom",
      "event_date": "2024-11-06T18:47:57",
      "has_unknown_time": false,
      "connection_expected": true,
      "conference_number": null,
      "conference_pin": null,
      "broadcast_url": "https://graphql.aiera.com/api/events/2175209/audio?api_key=API_KEY",
      "replay_url": null,
      "slides_url": null,
      "slides_url_type": null,
      "press_url": null,
      "press_url_type": null,
      "fiscal_quarter": null,
      "fiscal_year": null,
      "public_url": "https://dashboard.aiera.com/p/evtmin/3b713fe2bd30ff35924a18c9650ede2d",
      "public_share_url": "https://dashboard.aiera.com/p/AMZN/event/11/06/2024/3b713fe2bd30ff35924a18c9650ede2d",
      "transcription_status": "active",
      "transcription_audio_url": null,
      "transcription_audio_offset_seconds": 241,
      "has_transcripts": true,
      "has_pricing": true,
      "status": "active",
      "created": "2024-11-06T18:42:28",
      "modified": "2024-11-07T03:23:06"
    },
    "summary": {
      "title": "Amazon's Q1 2021 Financial Highlights: Strong Growth Amid Pandemic Challenges",
      "summary": [
        "The ASR CLI Test: 2024-11-06T23:42:26.805167 event discussed Amazon's Q1 2021 financial results. Key highlights included accelerated AWS revenue growth and expanded infrastructure, with plans for 15 more availability zones in 5 regions. The consumer business saw strong global demand, with international segment revenue growing 50% year-over-year on an FX-neutral basis. North America revenue grew 39%. Third-party seller services revenue increased 60% year-over-year, with 3P units representing 55% of total paid units. Prime Video streaming hours increased over 70% year-over-year. Risks mentioned included pandemic-related uncertainties affecting operations, consumer demand, and economic activity. The company emphasized its focus on employee safety measures and the trend of enterprises moving to cloud services. No specific forward-looking guidance was provided in the transcript."
      ],
      "model": "zeroshot",
      "type": "everything",
      "version": "live",
      "audio_clip": null,
      "video_clip": null,
      "priority": 2,
      "created": "2024-11-06T19:44:06",
      "modified": null
    }
  },
  {
    "event": {
      "event_id": 2646352,
      "equity_id": 1,
      "local_ticker": "AMZN",
      "bloomberg_ticker": "AMZN:US",
      "ric": "AMZN.OQ",
      "isin": "US0231351067",
      "permid": "4295905494",
      "exchange_mic": "XNAS",
      "title": "Q3 2024 Amazon.com Inc Earnings Call",
      "event_type": "earnings",
      "event_date": "2024-10-31T17:00:00",
      "has_unknown_time": false,
      "connection_expected": true,
      "conference_number": null,
      "conference_pin": null,
      "broadcast_url": "https://events.q4inc.com/attendee/878809675",
      "replay_url": "https://events.q4inc.com/attendee/878809675",
      "slides_url": "https://a.aiera.com/api/events/2646352/assets/press_url",
      "slides_url_type": "confirmed",
      "press_url": "https://a.aiera.com/api/events/2646352/assets/press_url",
      "press_url_type": "estimated",
      "fiscal_quarter": 3,
      "fiscal_year": 2024,
      "public_url": "https://dashboard.aiera.com/p/evtmin/800d9a8be300fa677fcc1747f76db158",
      "public_share_url": "https://dashboard.aiera.com/p/AMZN/event/10/31/2024/800d9a8be300fa677fcc1747f76db158",
      "transcription_status": "active",
      "transcription_audio_url": null,
      "transcription_audio_offset_seconds": 236,
      "has_transcripts": true,
      "has_pricing": true,
      "status": "active",
      "created": "2024-10-18T14:43:56",
      "modified": "2024-11-01T03:00:21"
    },
    "summary": {
      "title": "Amazon Q3 2023 Earnings: Revenues Surge to $158.9B, AWS Growth Drives 56% Operating Income Increase Amid Strong Prime Membership Expansion",
      "summary": [
        "In the third quarter of 2023, Amazon.com Inc. reported revenues of $158.9 billion, reflecting an 11% year-over-year increase when excluding foreign exchange impacts. The company's operating income surged to $17.4 billion, marking a significant 56% year-over-year rise. Adjusted trailing 12-month free cash flow reached $46.1 billion, up 128% or $25.9 billion year-over-year. The North America segment generated $95.5 billion in revenue, a 9% increase, while the international segment saw revenues of $35.9 billion, up 12%. Paid units grew by 12% year-over-year, driven by strong Prime membership growth following successful Prime events. Amazon Web Services (AWS) achieved a revenue increase of 19.1% year-over-year, totaling $27.5 billion, with an annualized run rate of $110 billion. AWS operating income rose to $10.4 billion, benefiting from cost control measures and an extended useful life for servers, contributing approximately 200 basis points to margin improvement. The company anticipates capital expenditures of approximately $75 billion in 2024, primarily to support growing demand for technology infrastructure and artificial intelligence services. Overall, Amazon's focus on customer-centric strategies, cost efficiencies, and innovation in logistics and technology positions it for continued growth in a competitive retail landscape."
      ],
      "model": "constrained",
      "type": "everything",
      "version": "published",
      "audio_clip": null,
      "video_clip": null,
      "priority": 1,
      "created": "2024-10-31T18:14:40",
      "modified": null
    }
  }
]

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"})