> ## 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.
# Get IdeaCloud questions
> Get the researched questions and clusters from an IdeaCloud
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
UUID of the IdeaCloud.
```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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.
## OpenAPI
````yaml GET /ideaclouds/{id}/questions
openapi: 3.1.0
info:
title: Hrizn Public API
version: 1.2.0
description: >
The Hrizn Public API allows partners to programmatically create content,
manage inventory descriptions, and integrate with the Hrizn platform.
All endpoints are prefixed with `/public` and require an API key passed via
the `X-API-Key` header (except the health check).
contact:
email: support@hrizn.io
servers:
- url: https://api.app.hrizn.io/v1/public
description: Production
security:
- apiKeyAuth: []
tags:
- name: IdeaClouds
description: Create and manage AI-powered keyword research
- name: Content Intelligence
description: AI-powered content gap analysis and recommendations
- name: Content
description: Generate content from IdeaClouds
- name: Compliance
description: Run OEM compliance checks on content
- name: Content Tools
description: Generate SEO metadata, schemas, and social snippets
- name: Inventory
description: Access vehicle data and AI descriptions
- name: Site
description: View dealership details and configuration
- name: Webhooks
description: Manage webhook subscriptions for real-time events
- name: Reference
description: Look up available types, scopes, and events
- name: Social
description: >-
Zernio-backed social posting and reviews across all connected platforms
(X, Facebook, Instagram, LinkedIn, Google Business Profile)
- name: Health
description: Health check (no authentication)
paths:
/ideaclouds/{id}/questions:
get:
tags:
- IdeaClouds
summary: Get questions and clusters
description: >-
Returns research questions and clusters. If research is in progress,
arrays are empty.
operationId: getIdeaCloudQuestions
parameters:
- $ref: '#/components/parameters/IdeaCloudId'
responses:
'200':
description: Questions and clusters
content:
application/json:
schema:
$ref: '#/components/schemas/IdeaCloudQuestionsResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'404':
$ref: '#/components/responses/NotFound'
'500':
$ref: '#/components/responses/InternalError'
components:
parameters:
IdeaCloudId:
name: id
in: path
required: true
schema:
type: string
format: uuid
description: IdeaCloud ID
schemas:
IdeaCloudQuestionsResponse:
type: object
properties:
data:
type: object
properties:
id:
type: string
format: uuid
status:
type: string
questions:
type: array
items:
type: object
properties:
id:
type: string
question:
type: string
cluster_id:
type: string
nullable: true
description: >-
References a cluster ID in the clusters array (format
`cluster-{index}`)
source_url:
type: string
nullable: true
source_title:
type: string
nullable: true
is_recommended:
type: boolean
clusters:
type: array
items:
type: object
properties:
id:
type: string
label:
type: string
question_count:
type: integer
recommended_question_ids:
type: array
items:
type: string
message:
type: string
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: validation_error
message:
type: string
example: 'keyword: Required'
details:
type: object
request_id:
type: string
responses:
BadRequest:
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Forbidden:
description: API key lacks required scope
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
NotFound:
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your Hrizn API key (prefix hzk_)
````