Skip to main content
POST
/
ideaclouds
Create IdeaCloud
curl --request POST \
  --url https://api.app.hrizn.io/v1/public/ideaclouds \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "keyword": "<string>"
}
'
{
  "data": {
    "id": "bd72cd59-beda-4ce5-a9a1-20acf16c9a5d",
    "status": "researching",
    "keyword": "2026 Chevrolet Equinox EV range and features",
    "created_at": "2026-02-28T11:39:55.287Z",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
Creates a new IdeaCloud that researches a keyword or topic, gathers questions from the web, clusters them by intent, and identifies the best angles for content. Scope required: ideaclouds:write

​
Request body

​
keyword
string
required
The keyword or topic to research. 1-500 characters.
​
category_id
string
Optional category UUID to associate with this IdeaCloud.

​
Response

Returns 202 Accepted with the IdeaCloud ID and initial status.
​
id
string
UUID of the created IdeaCloud.
​
status
string
Initial status: researching.
​
keyword
string
The keyword being researched.
​
created_at
string
ISO 8601 timestamp.
​
message
string
Informational message about async processing and webhook configuration.
{
  "data": {
    "id": "bd72cd59-beda-4ce5-a9a1-20acf16c9a5d",
    "status": "researching",
    "keyword": "2026 Chevrolet Equinox EV range and features",
    "created_at": "2026-02-28T11:39:55.287Z",
    "message": "Generation typically completes within a few minutes. Configure webhooks to receive real-time status notifications: https://api-docs.hrizn.io/webhooks"
  }
}
IdeaCloud research is asynchronous and typically completes within a few minutes. Configure webhooks to receive real-time ideacloud.completed and ideacloud.failed notifications instead of polling.

Authorizations

​
X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Body

application/json
​
keyword
string
required

Keyword or topic to research

Required string length: 1 - 500
​
category_id
string<uuid>

Optional category UUID

Response

IdeaCloud created and research started

​
data
object
Last modified on March 1, 2026