Research

Get research authors

Search and list research authors by name or provider.


GET /research-v1/available-authors

ParameterTypeDataTypeDescription
searchquerystringAuthor name search (partial match)
provider_idquerystringFilter authors by provider ID
pagequeryintegerPage number (default: 1)
page_sizequeryintegerItems per page (default: 50, max: 100)

NOTE

  • Authentication requires a user-level API key with research entitlements.
  • Uses page-based pagination.
  • When search is provided, applies a partial match filter on the author display name.
  • When provider_id is provided, restricts results to authors from that provider.

Request

https://premium.aiera.com/api/research-v1/available-authors?search=smith&page_size=10

Response

{
  "pagination": {
    "total_count": 8,
    "current_page": 1,
    "total_pages": 1,
    "page_size": 8
  },
  "data": [
    {
      "author_id": "author_001",
      "name": "Jane Smith"
    },
    {
      "author_id": "author_042",
      "name": "Robert Smithson"
    }
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/research-v1/available-authors?search=smith' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/research-v1/available-authors", params={"search": "smith"}, headers={"X-API-Key": "xxx"})
Previous
Get Providers