Content intelligence types

List content intelligence types

curl --request GET \
  --url https://api.app.hrizn.io/v1/public/reference/content-intelligence-types \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.app.hrizn.io/v1/public/reference/content-intelligence-types"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/reference/content-intelligence-types', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/reference/content-intelligence-types', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/reference/content-intelligence-types",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "content_intelligence_types": [
      {
        "type": "missing_model_page",
        "description": "A vehicle model in inventory has no dedicated research/landing page",
        "actionable_via": "POST /model-landing-pages"
      },
      {
        "type": "comparison_opportunity",
        "description": "Two or more cross-shopped vehicles can be compared in a head-to-head article",
        "actionable_via": "POST /comparisons"
      },
      {
        "type": "ideacloud_content",
        "description": "An existing IdeaCloud has unanswered questions that could become new content",
        "actionable_via": "POST /ideaclouds"
      }
    ]
  }
}

GET

reference

content-intelligence-types

List content intelligence types

curl --request GET \
  --url https://api.app.hrizn.io/v1/public/reference/content-intelligence-types \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.app.hrizn.io/v1/public/reference/content-intelligence-types"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/reference/content-intelligence-types', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/reference/content-intelligence-types', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/reference/content-intelligence-types",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "content_intelligence_types": [
      {
        "type": "missing_model_page",
        "description": "A vehicle model in inventory has no dedicated research/landing page",
        "actionable_via": "POST /model-landing-pages"
      },
      {
        "type": "comparison_opportunity",
        "description": "Two or more cross-shopped vehicles can be compared in a head-to-head article",
        "actionable_via": "POST /comparisons"
      },
      {
        "type": "ideacloud_content",
        "description": "An existing IdeaCloud has unanswered questions that could become new content",
        "actionable_via": "POST /ideaclouds"
      }
    ]
  }
}

Returns all recommendation types generated by the content intelligence pipeline, with a description of each type and the API endpoint to use for acting on it.

Type	Description	Actionable via
`missing_model_page`	A vehicle model in inventory has no dedicated research/landing page	`POST /model-landing-pages`
`comparison_opportunity`	Two or more cross-shopped vehicles can be compared	`POST /comparisons`
`ideacloud_content`	An existing IdeaCloud has unanswered questions that could become content	`POST /ideaclouds`
`ideacloud_question`	A specific unanswered question in an IdeaCloud can become targeted content	`POST /ideaclouds`
`content_refresh`	An existing article is declining in traffic and should be refreshed	`POST /content/{id}/generate`
`trending_topic`	A topic is trending in search data and has no coverage	`POST /ideaclouds`
`search_gap`	A high-impression search query has no matching content	`POST /ideaclouds`
`seasonal_content`	A seasonal topic is timely and relevant for the current period	`POST /ideaclouds`
`network_benchmark`	Peer dealerships have content coverage that this site is missing	`POST /ideaclouds`
`network_winning_pattern`	A content pattern is performing well across the peer network	`POST /ideaclouds`
`inventory_move`	A vehicle in inventory needs content attention — aging stock, high volume, or price segment	`POST /model-landing-pages`
`price_segment_content`	A price segment has no targeted content	`POST /ideaclouds`
`search_position_opportunity`	A query ranking on page 2 could move to page 1	`POST /ideaclouds`
`keyword_cannibalization`	Multiple pages compete for the same keyword	`POST /ideaclouds`
`model_year_transition`	A new model year is arriving and needs updated content	`POST /model-landing-pages`
`oem_event`	An OEM-sponsored campaign or incentive event is available	`POST /sales-events`
`local_event`	A local community event is an opportunity for content	`POST /sales-events`
`seasonal_event`	A seasonal sales event should be promoted	`POST /sales-events`
`community_event`	A community-focused event can drive local engagement	`POST /sales-events`
`model_launch_event`	A new model launch event is an opportunity for promotion	`POST /sales-events`
`recall_content`	An NHTSA recall for a vehicle in inventory can become safety content	`POST /ideaclouds`
`service_content`	A service interval milestone for a popular model can become maintenance content	`POST /ideaclouds`

{
  "data": {
    "content_intelligence_types": [
      {
        "type": "missing_model_page",
        "description": "A vehicle model in inventory has no dedicated research/landing page",
        "actionable_via": "POST /model-landing-pages"
      },
      {
        "type": "comparison_opportunity",
        "description": "Two or more cross-shopped vehicles can be compared in a head-to-head article",
        "actionable_via": "POST /comparisons"
      },
      {
        "type": "ideacloud_content",
        "description": "An existing IdeaCloud has unanswered questions that could become new content",
        "actionable_via": "POST /ideaclouds"
      }
    ]
  }
}

The actionable_via field indicates which existing API endpoint to call to act on a recommendation of this type. Use the recommendation’s metadata to populate the request body. See the Content Intelligence guide for a full workflow walkthrough.

Authorizations

X-API-Key

string

header

required

Your Hrizn API key (prefix hzk_)

Response

All content intelligence types

data

object

Hide child attributes

data.content_intelligence_types

object[]

Hide child attributes

data.content_intelligence_types.type

string

Recommendation type identifier

data.content_intelligence_types.description

string

Human-readable description of the recommendation type

data.content_intelligence_types.actionable_via

string

API endpoint to call to act on this recommendation type

Last modified on March 15, 2026

Content types

Component types

Overview

IdeaClouds