content_intelligence:read

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

Returns a paginated list of content intelligence recommendations for your site. Filter by type, priority, status, or suggested article type to find the most relevant opportunities.

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"

const res = await fetch(
  "https://api.app.hrizn.io/v1/public/content-intelligence?priority_min=80&limit=10",
  { headers: { "X-API-Key": "hzk_your_key_here" } }
);
const data = await res.json();

import requests

response = requests.get(
    "https://api.app.hrizn.io/v1/public/content-intelligence",
    headers={"X-API-Key": "hzk_your_key_here"},
    params={"priority_min": 80, "limit": 10},
)
data = response.json()

$url = "https://api.app.hrizn.io/v1/public/content-intelligence?" . http_build_query([
    "priority_min" => 80,
    "limit" => 10,
]);
$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: hzk_your_key_here"],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch));

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"]
    }
  }
}

Getting Started

Concepts

Guides

Scopes

Endpoints

List recommendations

Query parameters

Example

Response — `200 OK`

Status codes

Error response — Missing scope

​Endpoints

​List recommendations

​Query parameters

​Example

​Response — 200 OK

​Status codes

​Error response — Missing scope

Endpoints

List recommendations

Query parameters

Example

Response — `200 OK`

Status codes

Error response — Missing scope