Research
Get research authors
Search and list research authors by name or provider.
GET /research-v1/available-authors
| Parameter | Type | DataType | Description |
|---|---|---|---|
| search | query | string | Author name search (partial match) |
| provider_id | query | string | Filter authors by provider ID |
| page | query | integer | Page number (default: 1) |
| page_size | query | integer | Items per page (default: 50, max: 100) |
NOTE
- Authentication requires a user-level API key with research entitlements.
- Uses page-based pagination.
- When
searchis provided, applies a partial match filter on the author display name. - When
provider_idis 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"})