What each tier promises
Unauthenticated. Lists exactly the tiers POST /v1/runs will accept, in ladder order, each with the display_name to print, the purpose line to show on its card and a recommended flag (false on every tier while the ladder is Light and Deep). The ENFORCED numbers are the pipeline’s own: sources.target_high is the fetch budget the width sweep enforces, and duration_estimate is the research profile’s estimate. What a card should PRINT is served beside them: duration_display, sources_display (from sources.typical_low–typical_high), words.typical_min–typical_max and description, which carry a measured envelope where one exists (Light, 2026-09-23) and otherwise repeat the enforced numbers. A client that renders a tier card must read it from here rather than hardcoding a band, which is how a Light run came to report 66 sources against an advertised 15–25 (E2E4-16).
Request
- Base URL: https://api.hyperresearch.ai
- URL: https://api.hyperresearch.ai/v1/tiers
- Auth: none required
Response
Tiers
Example response
{
"data": [
{
"display_name": "Deep",
"purpose": "Investigate a broader question across several research sections",
"sources_display": "about 20–50 sources",
"duration_display": "about 30–40 min"
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.