Events

Get event

Fetch a specific event


GET /events-v2/{event_id}

ParameterTypeDataTypeDescription
linguisticsquerybooleanWhether to include linguistics metadata in the response
pricingquerybooleanWhether to include price reaction information
transcriptsquerybooleanWhether to include event transcripts, if available
improved_onlyquerybooleanWhether or not to only return the post-realtime improved transcripts
include_deletedquerybooleanWhether or not to include deleted transcripts (if available)
include_everythingquerybooleanWhether or not to include any transcripts, regardless of offset (if available)
include_tagsquerybooleanWhether or not to include transcript tagging (presentation, Q&A, etc)
word_offsetsquerybooleanWhether to include word-by-word durations and offsets

Response

{
    "event_id": 2270838,
    "equity_id": 1,
    "company_id": 1,
    "ticker": "AMZN:US",
    "local_ticker": "AMZN",
    "bloomberg_ticker": "AMZN:US",
    "ric": "AMZN.OQ",
    "permid": "4295905494",
    "isin": "US0231351067",
    "exchange_mic": "XNAS",
	"primary_equity": true,
    "title": "Q3 2022 Amazon.com Inc Earnings Call",
    "event_type": "earnings",
    "event_date": "2022-10-27T17:30:00-04:00",
    "has_unknown_time": false,
    "connection_expected": true,
    "fiscal_year": 2022,
    "fiscal_quarter": 3,
    "broadcast_url": "https://events.q4inc.com/attendee/219573186",
    "replay_url": "https://events.q4inc.com/attendee/219573186",
    "slides_url": "https://a.aiera.com/api/events/2270838/assets/slides_url",
    "press_url": "https://a.aiera.com/api/events/2270838/assets/press_url",
    "public_url": "https://dashboard.aiera.com/p/event/shared/f0cd1b8e3e23bead3c069979cbedc714",
    "live_asr_provider": "aiera",
    "transcription_status": "published",
    "transcription_audio_url": "https://audio.aiera.com/api/events/2270838/audio",
    "transcription_audio_offset_seconds": 0,
    "audio_offset_start": 0,
    "audio_offset_end": 19284,
    "audio_stream_url": "https://storage.media.aiera.com/2270838",
    "has_transcripts": true,
    "has_pricing": true,
    "corporate_activity_id": "42b11d4e-9d81-11ee-a86d-040106a3ab01",
    "grouping": {
		"grouping_id": 12345,
		"grouping_name": "Sellside Technology Conference"
	},
    "status": "active",
    "created": "2022-10-14T02:03:13-04:00",
    "modified": "2022-10-28T03:07:31-04:00",
    "linguistics": {
        "summaries": [
            {
                "title": "Amazon Reports on Prime Day, NFL Thursday Night Football, and Capital Investments for 2022",
                "summary": [
                    "Dave Fildes, Vice President of Investor Relations, reported that Amazon had a successful third quarter with worldwide net sales increasing 19% year-over-year. Prime Day and NFL Thursday Night Football were two major events that drove growth during the quarter. Operating income was $2.5 billion and net income was $2.9 billion, which included a pretax valuation gain of $1.1 billion from an investment in Rivian Automotive.",
                    "Amazon expects to spend approximately $60 billion in capital investments for the full year 2022, which is a reduction of $10 billion from last year. This decrease is offset by a $10 billion increase in technology infrastructure investments to support AWS growth. Due to macroeconomic issues such as inflation and rising energy costs, Amazon is taking actions such as pausing hiring in certain businesses and winding down products and services in order to strike the right balance between investing for customers and driving operational efficiency improvements. Amazon is focused on providing the best customer experience and believes that this is the only reliable way to create lasting value for shareholders."
                ],
                "model": "zeroshot",
                "type": "presentation",
                "version": "published",
                "audio_clip": "https://audio.aiera.com/api/summaries/2270838/zeroshot/audio",
                "video_clip": "https://audio.aiera.com/api/summaries/2270838/zeroshot/video",
                "priority": 2,
				"created": "2023-03-24T17:35:23",
				"modified": "2023-03-24T18:28:52"
            }
        ],
        "topics": [
            {
                "topic_id": 2544,
                "topic": "AWS",
                "priority": 1,
                "events": null
            },
            {
                "topic_id": 15288,
                "topic": "Prime",
                "priority": 2,
                "events": null
            },
            {
                "topic_id": 93,
                "topic": "Inflation",
                "priority": 3,
                "events": null
            },
            {
                "topic_id": 765,
                "topic": "North America",
                "priority": 4,
                "events": null
            },
            {
                "topic_id": 1995,
                "topic": "Advertising",
                "priority": 5,
                "events": null
            },
            {
                "topic_id": 61,
                "topic": "Supply Chain",
                "priority": 6,
                "events": null
            },
            {
                "topic_id": 22,
                "topic": "Cash Flow",
                "priority": 7,
                "events": null
            },
            {
                "topic_id": 556490,
                "topic": "Graviton",
                "priority": 8,
                "events": null
            },
            {
                "topic_id": 9192,
                "topic": "Acquisition",
                "priority": 9,
                "events": null
            },
            {
                "topic_id": 516645,
                "topic": "EC2",
                "priority": 10,
                "events": null
            }
        ],
        "auto_tags": [
            "Guidance Change",
            "Expense Forecast",
            "Revenue Miss"
        ],
        "sentiment": {
            "average": 0.19124993989746902,
			"median": 0.21317552693208427,
			"minimum": -0.7531,
			"maximum": 0.9274
        }
    }
}

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"})
Previous
Find Events