Get Person

Get a speaker's name, titles, representations, and events in which they spoke

GET /people/{person_id}

Returns details for a specific person including their speaker representations and events.

Request

https://premium.aiera.com/api/people/12345

Response

{
  "person_id": 100411,
  "parent_id": null,
  "name": "Andrew D. Baglino",
  "representations": [
    {
      "speaker_id": 67890,
      "name": "Andrew Baglino",
      "title": "SVP of Powertrain & Energy Engineering",
      "firm": {
        "firm_id": 123,
        "firm": "Tesla Inc",
        "domain": "tesla.com"
      }
    }
  ],
  "events": [
    {
      "event_id": 2329999,
      "title": "Q4 2022 Tesla Inc Earnings Call",
      "event_type": "earnings",
      "event_date": "2023-01-25T17:30:00",
      "transcription_audio_url": "https://audio.aiera.com/api/events/2329999/audio",
      "transcription_audio_offset_seconds": 180,
      "equity": {
        "equity_id": 5,
        "name": "TESLA INC",
        "common_name": "Tesla",
        "local_ticker": "TSLA",
        "ric": "TSLA.OQ",
        "bloomberg_ticker": "TSLA:US",
        "isin": "US88160R1014",
        "gics_sector": "Consumer Discretionary",
        "gics_sub_sector": "Automobile Manufacturers"
      },
      "transcripts": [
        {
          "speaker_id": 67890,
          "event_id": 2329999,
          "transcript_item_id": 456789,
          "start_ms": 120000,
          "start_timestamp": "2023-01-25T17:32:00",
          "duration_ms": 45000,
          "transcript": "Thank you for the question. Regarding our battery technology..."
        }
      ]
    }
  ]
}

Note:

• The parent_id field indicates if this person is a child record merged under a parent person.
• The representations array contains all speaker identities associated with this person across different events.
• The firm field in representations may be null if no firm is associated.
• The transcripts array in each event contains all transcript segments where this person spoke.

Alternative Endpoint: GET /events-v2/person/{person_id}

This is an alternative endpoint that returns similar data with a different response structure.

Request

https://premium.aiera.com/api/events-v2/person/100411

Response

{
  "name": "Andrew D. Baglino",
  "titles": [
    "SVP of Powertrain & Energy Engineering",
    "CTO"
  ],
  "events": [
    {
      "event_id": 2329999,
      "call_type": "earnings",
      "call_date": "2023-01-25T17:30:00",
      "title": "Q4 2022 Tesla Inc Earnings Call"
    }
  ],
  "q_and_a": [
    {
      "event_id": 1566875,
      "question": {
        "summary": {
          "extract": "...",
          "abridged": null
        },
        "speakers": [
          {
            "person_id": 100411,
            "speaker_name": "Andrew D. Baglino"
          }
        ],
        "linguistics": {
          "tonal": null,
          "topics": [
            {
              "topic": "Supply Chain",
              "position": 1,
              "topic_id": 61
            }
          ],
          "sentiments": {
            "median": 0.36005,
            "average": 0.29241,
            "maximum": 0.7184,
            "minimum": 0
          }
        }
      },
      "answer": {
        "summary": {
          "extract": "...",
          "abridged": null
        },
        "speakers": [
          {
            "person_id": 100411,
            "speaker_name": "Andrew D. Baglino"
          }
        ],
        "linguistics": {
          "tonal": -0.317011,
          "topics": [
            {
              "topic": "Cybertruck",
              "position": 1,
              "topic_id": 2645497
            }
          ],
          "sentiments": {
            "median": 0.4019,
            "average": 0.219,
            "maximum": 0.8934,
            "minimum": -0.4449
          }
        }
      }
    }
  ]
}

Code Samples

Bash

# Using /people endpoint
curl --request GET \
  --url 'https://premium.aiera.com/api/people/{person_id}' \
  --header 'X-API-Key: xxx'

# Using /events-v2/person endpoint
curl --request GET \
  --url 'https://premium.aiera.com/api/events-v2/person/{person_id}' \
  --header 'X-API-Key: xxx'

Python

import requests

# Using /people endpoint
requests.get("https://premium.aiera.com/api/people/{person_id}", headers={"X-API-Key": "xxx"})

# Using /events-v2/person endpoint
requests.get("https://premium.aiera.com/api/events-v2/person/{person_id}", headers={"X-API-Key": "xxx"})