Skip to main content
GET
/
ideaclouds
List IdeaClouds
curl --request GET \
  --url https://api.app.hrizn.io/v1/public/ideaclouds \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "23a66cb1-f5d9-4c91-b9d2-06c8203bd251",
      "keyword": "2026 Chevy Silverado 3500 DRW",
      "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
      "synopsis": "Comprehensive exploration of the 2026 Chevy Silverado 3500 DRW, covering specs, features, comparisons, and ownership considerations.",
      "status": "complete",
      "category": null,
      "created_at": "2026-02-27T20:47:44.372053+00:00",
      "updated_at": "2026-02-27T20:47:44.372053+00:00"
    },
    {
      "id": "c65aed07-891e-478a-a5c0-9c07c41171f1",
      "keyword": "2026 Chevy Silverado 3500 DRW",
      "title": "2026 Chevy Silverado 3500 DRW: The Definitive Guide",
      "synopsis": "This research consolidates 92 frequently asked questions about the 2026 Chevy Silverado 3500 DRW (dually) to create a comprehensive resource.",
      "status": "complete",
      "category": null,
      "created_at": "2026-02-27T20:47:29.94934+00:00",
      "updated_at": "2026-02-27T20:47:29.94934+00:00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMi0yN1QyMDo0NzoyOS45NDkzNCswMDowMCIsImlkIjoiYzY1YWVkMDctODkxZS00NzhhLWE1YzAtOWMwN2M0MTE3MWYxIn0=",
    "total_count": 77
  }
}
Returns a paginated list of IdeaClouds for the site associated with your API key. Scope required: ideaclouds:read

​
Query parameters

​
limit
integer
default:"25"
Results per page (1-100).
​
cursor
string
Pagination cursor from a previous response.
​
status
string
Filter by status. Possible values: researching (research in progress), complete (ready to use for content creation), failed (research encountered an error).
​
keyword
string
Search by keyword (case-insensitive partial match).

​
Response

​
category
object | null
The category assigned to this IdeaCloud, containing id and name. Returns null if no category is assigned.
{
  "data": [
    {
      "id": "23a66cb1-f5d9-4c91-b9d2-06c8203bd251",
      "keyword": "2026 Chevy Silverado 3500 DRW",
      "title": "2026 Chevy Silverado 3500 DRW: Deep Dive",
      "synopsis": "Comprehensive exploration of the 2026 Chevy Silverado 3500 DRW, covering specs, features, comparisons, and ownership considerations.",
      "status": "complete",
      "category": null,
      "created_at": "2026-02-27T20:47:44.372053+00:00",
      "updated_at": "2026-02-27T20:47:44.372053+00:00"
    },
    {
      "id": "c65aed07-891e-478a-a5c0-9c07c41171f1",
      "keyword": "2026 Chevy Silverado 3500 DRW",
      "title": "2026 Chevy Silverado 3500 DRW: The Definitive Guide",
      "synopsis": "This research consolidates 92 frequently asked questions about the 2026 Chevy Silverado 3500 DRW (dually) to create a comprehensive resource.",
      "status": "complete",
      "category": null,
      "created_at": "2026-02-27T20:47:29.94934+00:00",
      "updated_at": "2026-02-27T20:47:29.94934+00:00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMi0yN1QyMDo0NzoyOS45NDkzNCswMDowMCIsImlkIjoiYzY1YWVkMDctODkxZS00NzhhLWE1YzAtOWMwN2M0MTE3MWYxIn0=",
    "total_count": 77
  }
}

Authorizations

​
X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Query Parameters

​
limit
integer
default:25

Number of results per page

Required range: 1 <= x <= 100
​
cursor
string

Base64-encoded pagination cursor

​
status
string

Filter by status (e.g. researching, complete, failed)

​
keyword
string

Case-insensitive partial match on keyword

Response

Paginated list of IdeaClouds

​
data
object[]
​
pagination
object
Last modified on March 1, 2026