List recommendations

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

import requests

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

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/content-intelligence', 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/content-intelligence', 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/content-intelligence",
  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": [
    {
      "id": "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
      "suggestion_type": "missing_model_page",
      "comparison_subtype": null,
      "title": "Create a 2026 Toyota Camry model page",
      "description": "The 2026 Toyota Camry has 14 units in inventory but no dedicated model research page. Creating one could capture high-intent search traffic.",
      "priority_score": 92,
      "metadata": {
        "make": "Toyota",
        "model": "Camry",
        "year": 2026,
        "inventory_count": 14,
        "estimated_monthly_searches": 8400
      },
      "suggested_article_type": "modellanding",
      "status": "active",
      "created_at": "2026-03-01T04:00:00.000Z",
      "expires_at": "2026-03-31T04:00:00.000Z"
    },
    {
      "id": "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
      "suggestion_type": "comparison_opportunity",
      "comparison_subtype": "cross_brand",
      "title": "Toyota Camry vs Honda Accord comparison",
      "description": "Cross-brand comparison opportunity: Toyota Camry and Honda Accord are frequently cross-shopped. A comparison article could capture competitive search traffic.",
      "priority_score": 85,
      "metadata": {
        "vehicles": [
          { "make": "Toyota", "model": "Camry", "year": 2026 },
          { "make": "Honda", "model": "Accord", "year": 2026 }
        ],
        "search_overlap_score": 0.78
      },
      "suggested_article_type": "comparison",
      "status": "active",
      "created_at": "2026-03-01T04:00:00.000Z",
      "expires_at": "2026-03-31T04:00:00.000Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAy...",
    "total_count": 47
  }
}

GET

content-intelligence

List recommendations

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

import requests

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

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/content-intelligence', 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/content-intelligence', 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/content-intelligence",
  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": [
    {
      "id": "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
      "suggestion_type": "missing_model_page",
      "comparison_subtype": null,
      "title": "Create a 2026 Toyota Camry model page",
      "description": "The 2026 Toyota Camry has 14 units in inventory but no dedicated model research page. Creating one could capture high-intent search traffic.",
      "priority_score": 92,
      "metadata": {
        "make": "Toyota",
        "model": "Camry",
        "year": 2026,
        "inventory_count": 14,
        "estimated_monthly_searches": 8400
      },
      "suggested_article_type": "modellanding",
      "status": "active",
      "created_at": "2026-03-01T04:00:00.000Z",
      "expires_at": "2026-03-31T04:00:00.000Z"
    },
    {
      "id": "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
      "suggestion_type": "comparison_opportunity",
      "comparison_subtype": "cross_brand",
      "title": "Toyota Camry vs Honda Accord comparison",
      "description": "Cross-brand comparison opportunity: Toyota Camry and Honda Accord are frequently cross-shopped. A comparison article could capture competitive search traffic.",
      "priority_score": 85,
      "metadata": {
        "vehicles": [
          { "make": "Toyota", "model": "Camry", "year": 2026 },
          { "make": "Honda", "model": "Accord", "year": 2026 }
        ],
        "search_overlap_score": 0.78
      },
      "suggested_article_type": "comparison",
      "status": "active",
      "created_at": "2026-03-01T04:00:00.000Z",
      "expires_at": "2026-03-31T04:00:00.000Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAy...",
    "total_count": 47
  }
}

Returns a paginated list of content intelligence recommendations generated by the nightly gap analysis pipeline. Recommendations identify content opportunities based on inventory, search data, seasonal trends, and competitive analysis. Scope required: content_intelligence:read

Query parameters

limit

integer

default:"25"

Results per page (1-100).

cursor

string

Pagination cursor from a previous response.

type

string

Filter by a single recommendation type. See Content intelligence types for all values.

types

string

Filter by multiple recommendation types (comma-separated). Example: missing_model_page,comparison_opportunity.

priority_min

integer

Minimum priority score (0-100). Only return recommendations with priority_score >= priority_min.

status

string

default:"active"

Filter by status: active (default), dismissed, acted_on, expired.

suggested_article_type

string

Filter by recommended content type: basic, qa, expert, modellanding, comparison, salesevent.

Response

suggestion_type

string

Type of recommendation (e.g. missing_model_page, comparison_opportunity). Determines which API endpoint to use for acting on the recommendation.

comparison_subtype

string | null

For comparison_opportunity type only: cross_brand, trim, or cross_category.

priority_score

integer

Priority from 0-100. Higher scores indicate more impactful content opportunities.

metadata

object

Type-specific data such as vehicle make/model/year, traffic estimates, competitor info. Shape varies by suggestion_type.

suggested_article_type

string | null

Recommended content type: basic, modellanding, comparison, salesevent, etc.

{
  "data": [
    {
      "id": "c3a1f8b2-7e4d-4a9c-b5e6-1234567890ab",
      "suggestion_type": "missing_model_page",
      "comparison_subtype": null,
      "title": "Create a 2026 Toyota Camry model page",
      "description": "The 2026 Toyota Camry has 14 units in inventory but no dedicated model research page. Creating one could capture high-intent search traffic.",
      "priority_score": 92,
      "metadata": {
        "make": "Toyota",
        "model": "Camry",
        "year": 2026,
        "inventory_count": 14,
        "estimated_monthly_searches": 8400
      },
      "suggested_article_type": "modellanding",
      "status": "active",
      "created_at": "2026-03-01T04:00:00.000Z",
      "expires_at": "2026-03-31T04:00:00.000Z"
    },
    {
      "id": "d4b2e9c3-8f5e-5b0d-c6f7-2345678901bc",
      "suggestion_type": "comparison_opportunity",
      "comparison_subtype": "cross_brand",
      "title": "Toyota Camry vs Honda Accord comparison",
      "description": "Cross-brand comparison opportunity: Toyota Camry and Honda Accord are frequently cross-shopped. A comparison article could capture competitive search traffic.",
      "priority_score": 85,
      "metadata": {
        "vehicles": [
          { "make": "Toyota", "model": "Camry", "year": 2026 },
          { "make": "Honda", "model": "Accord", "year": 2026 }
        ],
        "search_overlap_score": 0.78
      },
      "suggested_article_type": "comparison",
      "status": "active",
      "created_at": "2026-03-01T04:00:00.000Z",
      "expires_at": "2026-03-31T04:00:00.000Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAy...",
    "total_count": 47
  }
}

Use the content intelligence types reference to understand each type and which API endpoint to call for acting on it.

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

type

string

Filter by a single recommendation type (e.g. missing_model_page). See /reference/content-intelligence-types for all values.

types

string

Filter by multiple recommendation types (comma-separated, e.g. missing_model_page,comparison_opportunity).

priority_min

integer

Minimum priority score (0-100). Only return recommendations with priority_score >= priority_min.

Required range: 0 <= x <= 100

status

enum<string>

default:active

Filter by status (default: active).

Available options:

active,

dismissed,

acted_on,

expired

suggested_article_type

enum<string>

Filter by recommended content type.

Available options:

basic,

qa,

expert,

modellanding,

comparison,

salesevent

Response

Paginated list of recommendations

data

object[]

Hide child attributes

data.id

string<uuid>

data.suggestion_type

string

Type of recommendation (e.g. missing_model_page, comparison_opportunity)

data.comparison_subtype

string | null

For comparison_opportunity type only: cross_brand, trim, or cross_category

data.title

string

Human-readable recommendation title

data.description

string

Detailed description of the content opportunity

data.priority_score

integer

Priority from 0-100. Higher scores indicate more impactful content opportunities.

Required range: 0 <= x <= 100

data.metadata

object

Type-specific data such as vehicle make/model/year, traffic estimates, competitor info. Shape varies by suggestion_type.

data.suggested_article_type

string | null

Recommended content type: basic, modellanding, comparison, salesevent, etc.

data.status

enum<string>

Available options:

active,

dismissed,

acted_on,

expired

data.created_at

string<date-time>

data.expires_at

string<date-time> | null

pagination

object

Hide child attributes

pagination.has_more

boolean

pagination.next_cursor

string | null

pagination.total_count

integer

Last modified on March 15, 2026

Get IdeaCloud questions

Get recommendation

Overview

IdeaClouds

Content Intelligence

Content

Content Types

Compliance

Content Tools

Inventory

Site

Dealership Config

Social

Webhooks

Reference

Health

IdeaClouds

Content

Compliance

Content Tools

Inventory

Site

Webhooks

Content Intelligence

Reference

Social

List recommendations

Query parameters

Response

Authorizations

Query Parameters

Response

​Query parameters

​Response

Authorizations

Query Parameters

Response

Query parameters

Response