Get event - Docs

Fetch a specific event

GET /events-v2/{event_id}

Parameter	Type	DataType	Description
linguistics	query	boolean	Whether to include linguistics metadata in the response
pricing	query	boolean	Whether to include price reaction information
transcripts	query	boolean	Whether to include event transcripts, if available
improved_only	query	boolean	Whether or not to only return the post-realtime improved transcripts
include_company_metadata	query	boolean	Whether to include the associated company's metadata (e.g. names, urls)
include_deleted	query	boolean	Whether or not to include deleted transcripts (if available)
include_connection_detail	query	boolean	Whether to include connection detail
include_hierarchy	query	boolean	Whether to include event hierarchy detail
include_estimated_docs	query	boolean	Whether to include model-estimated event docs
include_everything	query	boolean	Whether or not to include any transcripts, regardless of offset (if available)
include_tags	query	boolean	Whether or not to include transcript tagging (presentation, Q&A, etc)
include_people_data	query	boolean	Whether or not to include people information for equity/event
word_offsets	query	boolean	Whether to include word-by-word durations and offsets

Request

https://premium.aiera.com/api/events-v2/2640524?linguistics=true&include_company_meta_data=true

Response

{
  "event_id": 2640524,
  "company_id": 2612,
  "equity_id": 15331,
  "ticker": "DMP:AU",
  "local_ticker": "DMP",
  "bloomberg_ticker": "DMP:AU",
  "ric": "DMP.AX",
  "permid": "4295856495",
  "isin": "AU000000DMP0",
  "exchange_mic": "XASX",
  "primary_equity": true,
  "title": "Domino's Pizza Enterprises Limited - Shareholder/Analyst Call",
  "event_type": "shareholder_meeting",
  "event_tags": [],
  "event_date": "2024-11-06T00:00:00-05:00",
  "expected_language": "en",
  "has_unknown_time": false,
  "connection_expected": true,
  "is_live": false,
  "machine_published": false,
  "human_verified": false,
  "broadcast_url": "https://meetings.linkgroup.com/agm/DMP24/register",
  "slides_url": "https://a.aiera.com/api/events/2640524/assets/press_url",
  "slides_url_type": "confirmed",
  "press_url": "https://a.aiera.com/api/events/2640524/assets/press_url?allow_estimated=true",
  "press_url_type": "estimated",
  "public_url": "https://dashboard.aiera.com/p/evtmin/e2ae5243e15ba3115ae81fba76d7351c",
  "public_share_url": "https://dashboard.aiera.com/p/DMP/event/11/06/2024/e2ae5243e15ba3115ae81fba76d7351c",
  "live_asr_provider": "backup",
  "transcription_status": "archived",
  "transcription_audio_url": "https://audio.aiera.com/api/events/2640524/audio?api_key=API_KEY",
  "transcription_audio_offset_seconds": 172,
  "audio_offset_start": 171709,
  "audio_stream_url": "https://storage.media.aiera.com/2640524/00000192ffd5626b-5922c12c-9f671b7d8f0490fbd79cfb16e30b18d1/index.mpd",
  "has_transcripts": true,
  "has_api_transcript": true,
  "has_pricing": false,
  "grouping": {
    "grouping_id": null,
    "grouping_name": null
  },
  "status": "active",
  "created": "2024-10-03T22:00:06-04:00",
  "modified": "2024-11-06T01:43:31-05:00",
  "linguistics": {
    "summaries": [
      {
        "title": "Leadership Transition and Financial Growth: Key Highlights from Domino's Pizza Enterprises Limited Shareholder Call",
        "summary": [
          "The Domino's Pizza Enterprises Limited Shareholder/Analyst Call covered several key topics. CEO Don Meij announced his retirement after 22 years, with Mark van Dyck appointed as the new CEO. The company reported FY2024 global sales increased 4.6% to $4.19 billion, with online sales up 7.5% to $3.37 billion. Underlying EBIT was $207.7 million. Australia/New Zealand earnings rose 10.4% to $124.1 million, while Europe's EBIT grew 26.6% to $70.7 million. However, Asian earnings declined $17.3 million due to challenges in Malaysia and Japan. The company maintained its long-term goal of 7,100 stores globally. Key focus areas include rebuilding value, strengthening franchisee partnerships, driving growth through customer value, and building a high-performance culture. The company faces ongoing challenges in Japan and France, with efforts underway to improve performance in those markets."
        ],
        "model": "zeroshot",
        "type": "everything",
        "version": "published",
        "audio_clip": null,
        "video_clip": null,
        "priority": 2,
        "created": "2024-11-06T01:42:34",
        "modified": null
      }
    ],
    "topics": [
      {
        "topic_id": 219686051,
        "topic": "AX ownership matters",
        "priority": 1,
        "events": null
      },
      ...,
      {
        "topic_id": 140803,
        "topic": "Uber",
        "priority": 15,
        "events": null
      }
    ],
    "auto_tags": [],
    "sentiment": {
      "average": 0.0,
      "median": 0.0,
      "minimum": 0.0,
      "maximum": 0.0
    }
  },
  "people": [
    {
      "person_id": 80,
      "name": "Morana McGarrigle",
      "in_event": false
    },
    ...,
    {
      "person_id": 690880,
      "name": "Mark van Dyck",
      "in_event": true
    }
  ]
}

Code Samples

Bash

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

Python

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