Surface questions and articles that pull a reader deeper into your content. These endpoints power the Explore front-end module.

Endpoint	Use it for
related_questions	Questions to show under an article
trending_questions	What readers are asking across the site
query_suggestion	Type-ahead over trending questions

All of them are fast, read-only, and safe to call on page load.

---

Examples

Example 1 — Questions under an article (simplest)

POST /v1/ask/related_questions
{ "product_id": "art-20260612-rates", "rows": 5 }

{
  "data": {
    "related_questions": [
      "What is the central bank's inflation forecast?",
      "How will the rate decision affect mortgages?"
    ]
  }
}

Render each string as a clickable chip. Send the reader to your answers page with the question pre-filled.

Example 2 — Trending questions on a homepage

POST /v1/ask/trending_questions
{ "rows": 10 }

For a multi-brand site, scope them:

POST /v1/ask/trending_questions
{ "rows": 10, "_meta": { "site": "markets" } }

{
  "data": {
    "miso_id": "b7c9…",
    "related_questions": ["…", "…"]
  }
}

Example 3 — Type-ahead over trending questions

As the reader types, complete against what other readers ask:

POST /v1/ask/query_suggestion
{ "q": "interest ra" }

{
  "message": "success",
  "data": {
    "took": 3,
    "completions": [
      "interest rate cuts 2026",
      "interest rates and mortgages"
    ]
  }
}