meta

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).

get/v1/tiers

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.