Find research

Find research documents with optional filters.

GET /research-v1

Parameter	Type	DataType	Description
search	query	string	Full-text search across title, abstract, and description
author_person_ids	query	string	Comma-separated author person IDs
provider_ids	query	string	Comma-separated provider IDs
regions	query	string	Comma-separated region types
countries	query	string	Comma-separated country codes
asset_classes	query	string	Comma-separated asset classes
asset_types	query	string	Comma-separated asset types
subjects	query	string	Comma-separated subjects
product_focuses	query	string	Comma-separated product focus values
discipline_types	query	string	Comma-separated discipline types
start_date	query	datetime	ISO format date string for range start (default: 1 year ago)
end_date	query	datetime	ISO format date string for range end (default: today)
search_after	query	string	Pagination cursor (comma-separated values from previous page)
page_size	query	integer	Results per page (default: 50, max: 100)

NOTE

Authentication requires a user-level API key with research entitlements.
Uses cursor-based pagination via search_after. Pass next_search_after from the previous response to fetch the next page.
Results are sorted by published_datetime descending.

Request

https://premium.aiera.com/api/research-v1/?search=semiconductor&start_date=2025-01-01&end_date=2026-03-01&page_size=10

Response

{
  "params": {
    "search": "semiconductor",
    "start_date": "2025-01-01T00:00:00",
    "end_date": "2026-03-01T00:00:00",
    "page_size": 10
  },
  "pagination": {
    "total": 245,
    "page_size": 10,
    "has_next_page": true,
    "next_search_after": "1709251200000,abc123"
  },
  "data": [
    {
      "document_id": "doc_001",
      "research_id": "res_001",
      "title": "Semiconductor Outlook 2025",
      "subtitle": "Industry trends and forecasts",
      "abstract": "An analysis of global semiconductor trends...",
      "description": "Comprehensive research on semiconductor industry...",
      "page": 1,
      "page_count": 24,
      "aiera_provider_id": "provider_001",
      "authors": [
        {
          "name": "Jane Smith",
          "author_id": "author_001"
        }
      ],
      "asset_classes": ["Equity"],
      "asset_types": ["Common Stock"],
      "subjects": ["Technology"],
      "countries": [
        {
          "code": "US",
          "name": "United States"
        }
      ],
      "regions": [
        {
          "region_type": "Americas"
        }
      ],
      "organization_name": "Example Research",
      "organization_type": "Broker",
      "product_category": "Research",
      "product_focus": "Equity Research",
      "published_datetime": "2025-06-15T10:30:00Z",
      "language": "English"
    }
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/research-v1/?search=semiconductor&page_size=10' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/research-v1/", params={"search": "semiconductor", "page_size": 10}, headers={"X-API-Key": "xxx"})