Skip to main content
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

MethodPathDescription
GET/public/content-intelligenceList recommendations
GET/public/content-intelligence/summaryGet 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

NameTypeDefaultDescription
limitinteger25Results per page (1-100)
cursorstring—Pagination cursor from a previous response
typestring—Filter by single recommendation type (e.g. missing_model_page)
typesstring—Filter by multiple types, comma-separated (e.g. missing_model_page,comparison_opportunity)
priority_mininteger—Minimum priority score (0-100)
statusstringactiveFilter by status: active, dismissed, acted_on, expired
suggested_article_typestring—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

CodeDescription
200Success
401Missing or invalid API key
403API key does not have content_intelligence:read scope
429Rate limit exceeded
500Internal 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"]
    }
  }
}
Last modified on March 12, 2026