Get research

Retrieve a specific research document by ID, optionally including full text content.

GET /research-v1/{research_id}

NOTE

• Authentication requires a user-level API key with research entitlements.
• When include_content=true, the response is enriched with full text chunks. The content field is an array of text strings, one per chunk.

Request

https://premium.aiera.com/api/research-v1/res_001?include_content=true

Response

{
  "document_id": "doc_001",
  "research_id": "res_001",
  "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",
  "content": [
    "The global semiconductor market is projected to grow...",
    "Key drivers include AI chip demand, automotive electronics..."
  ]
}

Code Samples

Bash

curl --request GET \
  --url 'https://premium.aiera.com/api/research-v1/res_001?include_content=true' \
  --header 'X-API-Key: xxx'

Python

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