Skip to main content
GET
/
ideaclouds
/
{id}
/
questions
Get questions and clusters
curl --request GET \
  --url https://api.app.hrizn.io/v1/public/ideaclouds/{id}/questions \
  --header 'X-API-Key: <api-key>'
{
  "data": {
    "id": "23a66cb1-f5d9-4c91-b9d2-06c8203bd251",
    "status": "complete",
    "questions": [
      {
        "id": "q-1772225333601-0",
        "question": "What is the maximum towing capacity of the 2026 Chevy Silverado 3500 DRW?",
        "cluster_id": "cluster-0",
        "source_url": "https://www.chevrolet.com/trucks/silverado/heavy-duty",
        "source_title": null,
        "is_recommended": true
      },
      {
        "id": "q-1772225333601-1",
        "question": "What is the maximum conventional towing capacity?",
        "cluster_id": "cluster-0",
        "source_url": "https://www.chevrolet.com/trucks/silverado/heavy-duty",
        "source_title": null,
        "is_recommended": false
      },
      {
        "id": "q-1772225333601-2",
        "question": "How much does the 6.6L gas engine tow in the 3500 DRW?",
        "cluster_id": "cluster-0",
        "source_url": "https://www.caranddriver.com/chevrolet/silverado-2500hd-3500hd",
        "source_title": null,
        "is_recommended": false
      }
    ],
    "clusters": [
      { "id": "cluster-0", "label": "Towing and Payload Capacity", "question_count": 29 },
      { "id": "cluster-1", "label": "Engine and Performance", "question_count": 15 }
    ],
    "recommended_question_ids": [
      "q-1772225333602-60",
      "q-1772225333601-0",
      "q-1772225333601-5"
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt

Use this file to discover all available pages before exploring further.

Returns the questions discovered during research, organized into clusters by search intent. Only available after the IdeaCloud reaches complete status. Scope required: ideaclouds:read

​
Path parameters

​
id
string
required
UUID of the IdeaCloud.
{
  "data": {
    "id": "23a66cb1-f5d9-4c91-b9d2-06c8203bd251",
    "status": "complete",
    "questions": [
      {
        "id": "q-1772225333601-0",
        "question": "What is the maximum towing capacity of the 2026 Chevy Silverado 3500 DRW?",
        "cluster_id": "cluster-0",
        "source_url": "https://www.chevrolet.com/trucks/silverado/heavy-duty",
        "source_title": null,
        "is_recommended": true
      },
      {
        "id": "q-1772225333601-1",
        "question": "What is the maximum conventional towing capacity?",
        "cluster_id": "cluster-0",
        "source_url": "https://www.chevrolet.com/trucks/silverado/heavy-duty",
        "source_title": null,
        "is_recommended": false
      },
      {
        "id": "q-1772225333601-2",
        "question": "How much does the 6.6L gas engine tow in the 3500 DRW?",
        "cluster_id": "cluster-0",
        "source_url": "https://www.caranddriver.com/chevrolet/silverado-2500hd-3500hd",
        "source_title": null,
        "is_recommended": false
      }
    ],
    "clusters": [
      { "id": "cluster-0", "label": "Towing and Payload Capacity", "question_count": 29 },
      { "id": "cluster-1", "label": "Engine and Performance", "question_count": 15 }
    ],
    "recommended_question_ids": [
      "q-1772225333602-60",
      "q-1772225333601-0",
      "q-1772225333601-5"
    ]
  }
}
Question IDs use the format q-{timestamp}-{index} (e.g. q-1772246824308-0), not UUIDs. Use these IDs as-is when passing selected_question_ids to the content creation and generation endpoints.
Cluster IDs use the format cluster-{index} (e.g. cluster-0). Each question’s cluster_id references one of the cluster objects in the clusters array.

Authorizations

​
X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Path Parameters

​
id
string<uuid>
required

IdeaCloud ID

Response

Questions and clusters

​
data
object
Last modified on March 1, 2026