Skip to main content
GET
/
content-intelligence
List recommendations
curl --request GET \
  --url https://api.app.hrizn.io/v1/public/content-intelligence \
  --header 'X-API-Key: <api-key>'
{
  "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[]
pagination
object
Last modified on March 12, 2026