> ## 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.
# List recommendations
> List AI-generated content intelligence recommendations for this site
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
Results per page (1-100).
Pagination cursor from a previous response.
Filter by a single recommendation type. See [Content intelligence types](/api-reference/reference/content-intelligence-types) for all values.
Filter by multiple recommendation types (comma-separated). Example: `missing_model_page,comparison_opportunity`.
Minimum priority score (0-100). Only return recommendations with `priority_score >= priority_min`.
Filter by status: `active` (default), `dismissed`, `acted_on`, `expired`.
Filter by recommended content type: `basic`, `qa`, `expert`, `modellanding`, `comparison`, `salesevent`.
## Response
Type of recommendation (e.g. `missing_model_page`, `comparison_opportunity`). Determines which API endpoint to use for acting on the recommendation.
For `comparison_opportunity` type only: `cross_brand`, `trim`, or `cross_category`.
Priority from 0-100. Higher scores indicate more impactful content opportunities.
Type-specific data such as vehicle make/model/year, traffic estimates, competitor info. Shape varies by `suggestion_type`.
Recommended content type: `basic`, `modellanding`, `comparison`, `salesevent`, etc.
```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"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](/api-reference/reference/content-intelligence-types) to understand each type and which API endpoint to call for acting on it.
## OpenAPI
````yaml GET /content-intelligence
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:
/content-intelligence:
get:
tags:
- Content Intelligence
summary: List recommendations
description: >-
Returns a paginated list of content intelligence recommendations
generated by the nightly gap analysis pipeline.
operationId: listContentIntelligence
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Cursor'
- name: type
in: query
schema:
type: string
description: >-
Filter by a single recommendation type (e.g. `missing_model_page`).
See `/reference/content-intelligence-types` for all values.
- name: types
in: query
schema:
type: string
description: >-
Filter by multiple recommendation types (comma-separated, e.g.
`missing_model_page,comparison_opportunity`).
- name: priority_min
in: query
schema:
type: integer
minimum: 0
maximum: 100
description: >-
Minimum priority score (0-100). Only return recommendations with
`priority_score >= priority_min`.
- name: status
in: query
schema:
type: string
default: active
enum:
- active
- dismissed
- acted_on
- expired
description: 'Filter by status (default: `active`).'
- name: suggested_article_type
in: query
schema:
type: string
enum:
- basic
- qa
- expert
- modellanding
- comparison
- salesevent
description: Filter by recommended content type.
responses:
'200':
description: Paginated list of recommendations
content:
application/json:
schema:
$ref: '#/components/schemas/ContentIntelligenceListResponse'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'429':
$ref: '#/components/responses/RateLimited'
'500':
$ref: '#/components/responses/InternalError'
components:
parameters:
Limit:
name: limit
in: query
schema:
type: integer
default: 25
minimum: 1
maximum: 100
description: Number of results per page
Cursor:
name: cursor
in: query
schema:
type: string
description: Base64-encoded pagination cursor
schemas:
ContentIntelligenceListResponse:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/ContentIntelligenceObject'
pagination:
$ref: '#/components/schemas/PaginationInfo'
ContentIntelligenceObject:
type: object
properties:
id:
type: string
format: uuid
suggestion_type:
type: string
description: >-
Type of recommendation (e.g. `missing_model_page`,
`comparison_opportunity`)
comparison_subtype:
type: string
nullable: true
description: >-
For `comparison_opportunity` type only: `cross_brand`, `trim`, or
`cross_category`
title:
type: string
description: Human-readable recommendation title
description:
type: string
description: Detailed description of the content opportunity
priority_score:
type: integer
minimum: 0
maximum: 100
description: >-
Priority from 0-100. Higher scores indicate more impactful content
opportunities.
metadata:
type: object
description: >-
Type-specific data such as vehicle make/model/year, traffic
estimates, competitor info. Shape varies by `suggestion_type`.
suggested_article_type:
type: string
nullable: true
description: >-
Recommended content type: `basic`, `modellanding`, `comparison`,
`salesevent`, etc.
status:
type: string
enum:
- active
- dismissed
- acted_on
- expired
created_at:
type: string
format: date-time
expires_at:
type: string
format: date-time
nullable: true
PaginationInfo:
type: object
properties:
has_more:
type: boolean
next_cursor:
type: string
nullable: true
total_count:
type: integer
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:
BadRequest:
description: Validation error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Unauthorized:
description: Missing or invalid API key
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Forbidden:
description: API key lacks required scope
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_)
````