> ## 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

> List and view content intelligence recommendations, dismiss recommendations

<code>content\_intelligence:read</code>

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

<CodeGroup>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl "https://api.app.hrizn.io/v1/public/content-intelligence?priority_min=80&limit=10" \
    -H "X-API-Key: hzk_your_key_here"
  ```

  ```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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();
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  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()
  ```

  ```php PHP theme={"theme":{"light":"github-light","dark":"github-dark"}}
  $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));
  ```
</CodeGroup>

### Response -- `200 OK`

```json 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.",
      "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:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "error": {
    "code": "forbidden",
    "message": "This API key requires one of the following scopes: content_intelligence:read",
    "details": {
      "required_scopes": ["content_intelligence:read"]
    }
  }
}
```