> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.hrizn.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Content intelligence types
> List all content intelligence recommendation types with descriptions and recommended actions
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` |
```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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](/guides/content-intelligence) for a full workflow walkthrough.
## OpenAPI
````yaml GET /reference/content-intelligence-types
openapi: 3.1.0
info:
title: Hrizn Public API
version: 1.2.0
description: >
The Hrizn Public API allows partners to programmatically create content,
manage inventory descriptions, and integrate with the Hrizn platform.
All endpoints are prefixed with `/public` and require an API key passed via
the `X-API-Key` header (except the health check).
contact:
email: support@hrizn.io
servers:
- url: https://api.app.hrizn.io/v1/public
description: Production
security:
- apiKeyAuth: []
tags:
- name: IdeaClouds
description: Create and manage AI-powered keyword research
- name: Content Intelligence
description: AI-powered content gap analysis and recommendations
- name: Content
description: Generate content from IdeaClouds
- name: Compliance
description: Run OEM compliance checks on content
- name: Content Tools
description: Generate SEO metadata, schemas, and social snippets
- name: Inventory
description: Access vehicle data and AI descriptions
- name: Site
description: View dealership details and configuration
- name: Webhooks
description: Manage webhook subscriptions for real-time events
- name: Reference
description: Look up available types, scopes, and events
- name: Social
description: >-
Zernio-backed social posting and reviews across all connected platforms
(X, Facebook, Instagram, LinkedIn, Google Business Profile)
- name: Health
description: Health check (no authentication)
paths:
/reference/content-intelligence-types:
get:
tags:
- Reference
summary: List content intelligence types
description: >-
Returns all recommendation types generated by the content intelligence
pipeline, with descriptions and recommended action endpoints.
operationId: getReferenceContentIntelligenceTypes
responses:
'200':
description: All content intelligence types
content:
application/json:
schema:
$ref: '#/components/schemas/ContentIntelligenceTypesResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
schemas:
ContentIntelligenceTypesResponse:
type: object
properties:
data:
type: object
properties:
content_intelligence_types:
type: array
items:
$ref: '#/components/schemas/ContentIntelligenceTypeDescriptor'
ContentIntelligenceTypeDescriptor:
type: object
properties:
type:
type: string
description: Recommendation type identifier
description:
type: string
description: Human-readable description of the recommendation type
actionable_via:
type: string
description: API endpoint to call to act on this recommendation type
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: string
example: validation_error
message:
type: string
example: 'keyword: Required'
details:
type: object
request_id:
type: string
responses:
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
RateLimited:
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
InternalError:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: Your Hrizn API key (prefix hzk_)
````