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:read
The content_intelligence:read scope provides access to AI-generated content intelligence recommendations from the nightly gap analysis pipeline. Recommendations identify content opportunities based on your inventory, search data, seasonal trends, and competitive analysis. Use this scope to list recommendations, view their details, get summary metrics, and dismiss ones you’ve reviewed.
Endpoints
| Method | Path | Description |
|---|
GET | /public/content-intelligence | List recommendations |
GET | /public/content-intelligence/summary | Get summary metrics |
GET | /public/content-intelligence/{id} | Get recommendation details |
PATCH | /public/content-intelligence/{id} | Dismiss a recommendation |
List recommendations
GET /public/content-intelligence
Query parameters
| Name | Type | Default | Description |
|---|
limit | integer | 25 | Results per page (1-100) |
cursor | string | — | Pagination cursor from a previous response |
type | string | — | Filter by single recommendation type (e.g. missing_model_page) |
types | string | — | Filter by multiple types, comma-separated (e.g. missing_model_page,comparison_opportunity) |
priority_min | integer | — | Minimum priority score (0-100) |
status | string | active | Filter by status: active, dismissed, acted_on, expired |
suggested_article_type | string | — | Filter by recommended content type |
Example
curl "https://api.app.hrizn.io/v1/public/content-intelligence?priority_min=80&limit=10" \
-H "X-API-Key: hzk_your_key_here"
Response — 200 OK
{
"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.",
"priority_score": 92,
"metadata": {
"make": "Toyota",
"model": "Camry",
"year": 2026,
"inventory_count": 14
},
"suggested_article_type": "modellanding",
"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
}
}
Status codes
| Code | Description |
|---|
200 | Success |
401 | Missing or invalid API key |
403 | API key does not have content_intelligence:read scope |
429 | Rate limit exceeded |
500 | Internal server error |
Error response — Missing scope
If your API key does not include content_intelligence:read, any request to these endpoints returns:
{
"error": {
"code": "forbidden",
"message": "This API key requires one of the following scopes: content_intelligence:read",
"details": {
"required_scopes": ["content_intelligence:read"]
}
}
}
