Find people

Search for people (speakers) by name

GET /people

NOTE

• The search parameter is required. Returns 400 Bad Request if not provided.
• Results are returned as a flat array (no pagination wrapper).

Request

https://premium.aiera.com/api/people?search=Tim%20Cook

Response

[
  {
    "person_id": 12345,
    "name": "Timothy D. Cook",
    "representations": [
      {
        "speaker_id": 67890,
        "name": "Tim Cook",
        "title": "Chief Executive Officer",
        "firm": {
          "firm_id": 1,
          "firm": "Apple Inc",
          "domain": "apple.com"
        }
      }
    ],
    "events": [
      {
        "event_id": 2640524,
        "title": "Q4 2024 Apple Inc Earnings Call",
        "event_type": "earnings",
        "event_date": "2024-11-01T17:00:00",
        "transcription_audio_url": "https://audio.aiera.com/api/events/2640524/audio",
        "transcription_audio_offset_seconds": 172,
        "equity": {
          "equity_id": 2,
          "name": "APPLE INC",
          "common_name": "Apple Inc",
          "local_ticker": "AAPL",
          "ric": "AAPL.OQ",
          "bloomberg_ticker": "AAPL:US",
          "isin": "US0378331005",
          "gics_sector": "Information Technology",
          "gics_sub_sector": "Technology Hardware, Storage & Peripherals"
        }
      }
    ]
  }
]

Note:

• The firm field in representations may be null if no firm is associated.
• Results are returned as a flat array ordered by relevance.

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/people?search=Tim%20Cook' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.get("https://premium.aiera.com/api/people?search=Tim%20Cook", headers={"X-API-Key": "xxx"})