Skip to main content
Base URL: https://api.app.hrizn.io/v1/public — all examples below use this production URL.
1

Get an API Key

Navigate to the Dealership Manager in the Hrizn Dashboard, select a dealership, and click the API tab. Click Create API Key, select the scopes you need, and copy the key.
The raw API key is shown only once at creation time. Store it securely.
API keys always start with the hzk_ prefix. If your key doesn’t start with hzk_, something went wrong — regenerate it from the dashboard.
2

Test the Connection

Verify your key works by hitting the health endpoint:
curl https://api.app.hrizn.io/v1/public/health
Then fetch your site details:
curl https://api.app.hrizn.io/v1/public/site \
  -H "X-API-Key: hzk_your_key_here"
You should get a response like:
{
  "data": {
    "id": "8eba316f-8424-4863-8f4b-e53c4a44d2b7",
    "name": "Empire Chevrolet of Huntington",
    "vertical": "automotive",
    "domain": "https://www.shopempirechevrolet.com",
    "city": "Huntington",
    "state": "NY",
    "zip": "11743",
    "created_at": "2024-11-08T16:21:08.780217+00:00",
    "updated_at": "2026-02-27T21:11:02.638221+00:00"
  }
}
3

Create an IdeaCloud

Start research on a topic:
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 Equinox EV range and features" }'
Response (202 Accepted):
{
  "data": {
    "id": "bd72cd59-beda-4ce5-a9a1-20acf16c9a5d",
    "status": "researching",
    "keyword": "2026 Chevrolet Equinox EV range and features"
  }
}
4

Poll for Completion

Check the IdeaCloud status:
curl https://api.app.hrizn.io/v1/public/ideaclouds/a1b2c3d4-... \
  -H "X-API-Key: hzk_your_key_here"
When status changes to complete, the IdeaCloud is ready.
Instead of polling, set up a webhook to receive a push notification when the IdeaCloud completes.
5

Generate Content

Create content from the completed IdeaCloud:
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": "a1b2c3d4-...",
    "article_type": "basic",
    "auto_compliance": true,
    "auto_content_tools": true
  }'
6

Retrieve the Content

Once the content is complete, get the HTML:
curl https://api.app.hrizn.io/v1/public/content/{id}/html \
  -H "X-API-Key: hzk_your_key_here"
Or get all components (body, SEO metadata, schemas, social snippets):
curl https://api.app.hrizn.io/v1/public/content/{id}/components \
  -H "X-API-Key: hzk_your_key_here"
You’ve completed the quickstart! You now know how to authenticate, create IdeaClouds, generate content, and retrieve the results.

​
What’s Next

Skip polling entirely by setting up real-time push notifications:

Webhooks Guide

Register endpoints and verify HMAC signatures.

Webhook Events

Browse all available event types.
Last modified on March 1, 2026