Find people

Search for people (speakers) by name

GET /people-v1

Parameter	Type	DataType	Description
search	query	string	Search term for person name (required)
page	query	integer	The page of results to return (default: 1)
page_size	query	integer	Results per page (default: 10, max: 100)

Request

https://premium.aiera.com/api/people-v1?search=Brian&page=1&page_size=5

Response

{
  "pagination": {
    "total_count": 1247,
    "current_page": 1,
    "total_pages": 250,
    "page_size": 5
  },
  "data": [
    {
      "person_id": 197,
      "name": "Brian Tanquilut",
      "parent_id": null
    },
    {
      "person_id": 198,
      "name": "Brian Kristjansen",
      "parent_id": null
    },
    {
      "person_id": 199,
      "name": "Brian Bagnell",
      "parent_id": null
    },
    {
      "person_id": 234,
      "name": "Brian Gong",
      "parent_id": null
    },
    {
      "person_id": 252,
      "name": "Brian Nowak",
      "parent_id": null
    }
  ]
}

Code Samples

Bash

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

Python

import requests
resp = requests.get(
    "https://premium.aiera.com/api/people-v1",
    params={"search": "Tim Cook", "page": 1, "page_size": 50},
    headers={"X-API-Key": "xxx"},
)