> ## 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 content
> List all content for this site
Returns a paginated list of content. **Scope required:** `content:read`
## Query parameters
Results per page (1-100).
Pagination cursor.
Filter by article type (`basic`, `qa`, `expert`, `modellanding`, `comparison`, `salesevent`).
Filter by content intent (`fixed_ops`, `variable`, `general`).
Filter by target audience (`in_market_buyer`, `service_customer`, `owner`, `general_public`, `enthusiast`).
Filter by funnel stage (`awareness`, `consideration`, `decision`, `retention`).
Filter by content lifespan (`evergreen`, `seasonal`, `time_bound`).
Filter by search intent type (`informational`, `commercial`, `transactional`, `navigational`).
## Response
Content status: `generating`, `complete`, or `failed`.
The category assigned to this content, containing `id` and `name`. Returns `null` if no category is assigned.
```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
"data": [
{
"id": "4d42cdcf-e24f-4123-960e-6c15761fcfcf",
"title": "Unveiling the Power and Performance of the 2026 Chevy Silverado 3500 DRW",
"article_type": "basic",
"status": "complete",
"category": {
"id": "b24ad569-f7ce-47ad-be44-cec02c0fab70",
"name": "2026 Chevy Silverado 3500 DRW"
},
"created_at": "2026-02-27T21:41:20.418301+00:00",
"updated_at": "2026-02-27T21:42:56.623718+00:00"
},
{
"id": "e3e864ce-06fc-477e-b032-8efd8c9e85cf",
"title": "2026 Chevrolet Trax for Sale in Huntington, NY",
"article_type": "modellanding",
"status": "complete",
"category": null,
"created_at": "2026-02-27T21:00:35.026534+00:00",
"updated_at": "2026-02-27T21:03:00.811516+00:00"
}
],
"pagination": {
"has_more": true,
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMi0yN1QyMTowMDozNS4wMjY1MzQrMDA6MDAiLCJpZCI6ImUzZTg2NGNlLTA2ZmMtNDc3ZS1iMDMyLThlZmQ4YzllODVjZiJ9",
"total_count": 487
}
}
```
## OpenAPI
````yaml GET /content
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:
get:
tags:
- Content
summary: List content
operationId: listContent
parameters:
- $ref: '#/components/parameters/Limit'
- $ref: '#/components/parameters/Cursor'
- name: article_type
in: query
schema:
$ref: '#/components/schemas/ArticleType'
description: Filter by article type
- name: content_intent
in: query
schema:
type: string
description: Filter by content intent (fixed_ops, variable, general)
- name: target_audience
in: query
schema:
type: string
description: >-
Filter by target audience (in_market_buyer, service_customer, owner,
general_public, enthusiast)
- name: funnel_stage
in: query
schema:
type: string
description: >-
Filter by funnel stage (awareness, consideration, decision,
retention)
- name: content_lifespan
in: query
schema:
type: string
description: Filter by content lifespan (evergreen, seasonal, time_bound)
- name: search_intent_type
in: query
schema:
type: string
description: >-
Filter by search intent type (informational, commercial,
transactional, navigational)
responses:
'200':
description: Paginated list of content
content:
application/json:
schema:
$ref: '#/components/schemas/ArticleListResponse'
'401':
$ref: '#/components/responses/Unauthorized'
'403':
$ref: '#/components/responses/Forbidden'
'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:
ArticleType:
type: string
enum:
- basic
- qa
- expert
- modellanding
- comparison
- salesevent
ArticleListResponse:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
format: uuid
title:
type: string
article_type:
$ref: '#/components/schemas/ArticleType'
status:
$ref: '#/components/schemas/ContentStatus'
category:
$ref: '#/components/schemas/CategoryObject'
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
content_intent:
type: string
nullable: true
description: Content intent classification (fixed_ops, variable, general)
target_audience:
type: string
nullable: true
description: >-
Target audience (in_market_buyer, service_customer, owner,
general_public, enthusiast)
funnel_stage:
type: string
nullable: true
description: >-
Buyer journey funnel stage (awareness, consideration,
decision, retention)
content_lifespan:
type: string
nullable: true
description: Content lifespan type (evergreen, seasonal, time_bound)
search_intent_type:
type: string
nullable: true
description: >-
Search intent type (informational, commercial, transactional,
navigational)
pagination:
$ref: '#/components/schemas/PaginationInfo'
ContentStatus:
type: string
enum:
- generating
- complete
- failed
description: Content generation status
CategoryObject:
type: object
nullable: true
description: Category assigned to this resource, or null if none.
properties:
id:
type: string
format: uuid
name:
type: string
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:
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'
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_)
````