Search research

Semantic search within research document chunks using hybrid neural and keyword search.

GET /research-v1/search

Parameter	Type	DataType	Description
search	query	string	Required. Search query text
document_ids	query	string	Comma-separated document IDs to limit search scope
start_date	query	string	ISO format start date filter
end_date	query	string	ISO format end date filter
author_ids	query	string	Comma-separated author person IDs
aiera_provider_ids	query	string	Comma-separated provider IDs
max_results	query	integer	Maximum results to return (default: 20, max: 50)
search_after	query	string	Pagination cursor (comma-separated values from previous page)

NOTE

Authentication requires a user-level API key with research entitlements.
Uses hybrid neural + keyword search for high-quality results.
Uses cursor-based pagination via search_after. Pass next_search_after from the previous response to fetch the next page.
Results are sorted by relevance score descending.

Request

https://premium.aiera.com/api/research-v1/search?search=AI%20chip%20demand&max_results=5

Response

{
  "params": {
    "query_text": "AI chip demand",
    "max_results": 5
  },
  "pagination": {
    "total": 128,
    "page_size": 5,
    "has_next_page": true,
    "next_search_after": "0.85,chunk_456"
  },
  "data": [
    {
      "chunk_id": "chunk_001",
      "document_id": "doc_001",
      "score": 0.92,
      "text": "AI chip demand is expected to double by 2026...",
      "page": 3,
      "page_count": 24,
      "title": "Semiconductor Outlook 2025",
      "subtitle": "Industry trends and forecasts",
      "description": "Comprehensive research on semiconductor industry...",
      "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",
      "research_id": "res_001",
      "content_id": 12345,
      "primary_equity_id": 100,
      "primary_company_id": 50,
      "date": "2025-06-15T10:30:00Z"
    }
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/research-v1/search?search=AI%20chip%20demand&max_results=5' \
  --header 'X-API-Key: xxx'

Python

import requests
requests.request("GET", "https://premium.aiera.com/api/research-v1/search", params={"search": "AI chip demand", "max_results": 5}, headers={"X-API-Key": "xxx"})