Skip to main content

​
Welcome

The Hrizn Public API enables partners and integrators to build powerful automations around the Hrizn content platform. Create IdeaClouds, generate content, run compliance checks, manage inventory descriptions, and receive real-time webhook notifications.

Quickstart

Get up and running in 5 minutes with your first API call.

Authentication

Learn how to create and manage API keys.

API Reference

Browse the full endpoint reference.

Webhooks

Receive real-time notifications when content is ready.

​
Content Creation Pipeline

The API follows a research-first workflow. Every piece of content starts with an IdeaCloud that gathers questions and clusters them by intent, then flows through generation, quality checks, and enrichment.

​
Core Workflow

The fastest path from keyword to published content:
1

Create an IdeaCloud

Send a keyword or topic to start research.
curl -X POST https://api.app.hrizn.io/v1/public/ideaclouds \
  -H "X-API-Key: hzk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "keyword": "2026 Chevrolet Silverado 1500 vs Ford F-150" }'
2

Generate Content

Once the IdeaCloud is complete, create content from it.
curl -X POST https://api.app.hrizn.io/v1/public/content \
  -H "X-API-Key: hzk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "ideacloud_id": "...",
    "article_type": "comparison",
    "auto_compliance": true,
    "auto_content_tools": true
  }'
3

Retrieve the Content

Fetch the full HTML and structured components.
GET /content/{id}/html
GET /content/{id}/components
Instead of polling for status, set up webhooks to receive push notifications when IdeaClouds and content are ready. This is the recommended approach for production integrations.

​
Features

IdeaClouds

AI-powered keyword research with clustered questions and intent analysis.

Content Generation

6 content types including comparisons, model landing pages, Q&A, and sales events.

Compliance Checks

OEM-specific compliance analysis with scoring and violation details.

Content Tools

SEO metadata, JSON-LD schemas, FAQ markup, and social media snippets.

Inventory

Vehicle data, AI-generated descriptions, and feed exports.

Webhooks

Real-time push notifications with HMAC-SHA256 signing and retry logic.

Rate Limiting

Configurable per-key rate limits with sliding window enforcement.

Scoped Access

Granular permissions per API key with preset configurations.
Last modified on March 1, 2026