List published content

curl --request GET \
  --url https://api.app.hrizn.io/v1/public/content/published \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/content/published', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/content/published', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/content/published",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": [
    {
      "id": "bccf2a98-55ad-437d-b0dc-d505d95c88cf",
      "title": "Land Cruiser vs Bronco Face-Off: Rugged Luxury or Off-Road Fun?",
      "article_type": "comparison",
      "status": "published",
      "slug": "land-cruiser-vs-bronco-rock-hill-comparison",
      "date": "2026-04-11T15:45:37.264+00:00",
      "published_at": "2026-04-11T15:45:37.264+00:00",
      "featured_image": "https://assets.hrizn.io/public/media-library/9c894353.../1771026288320.png",
      "citation_url": "https://www.exampledealer.com/blog/land-cruiser-vs-bronco-rock-hill-comparison",
      "created_at": "2026-02-13T22:56:41.872443+00:00",
      "updated_at": "2026-04-11T15:45:37.297587+00:00"
    },
    {
      "id": "e3e864ce-06fc-477e-b032-8efd8c9e85cf",
      "title": "2026 Toyota Corolla Cross Hybrid Fuel Economy Guide",
      "article_type": "basic",
      "status": "scheduled",
      "slug": "2026-corolla-cross-hybrid-fuel-economy",
      "date": "2026-04-15T09:00:00.000+00:00",
      "published_at": null,
      "featured_image": null,
      "citation_url": null,
      "created_at": "2026-03-01T14:20:00.000+00:00",
      "updated_at": "2026-04-10T18:30:00.000+00:00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wMVQxNDoyMDowMC4wMDArMDA6MDAiLCJpZCI6ImUzZTg2NGNlLTA2ZmMtNDc3ZS1iMDMyLThlZmQ4YzllODVjZiJ9",
    "total_count": 42
  }
}

GET

content

published

List published content

curl --request GET \
  --url https://api.app.hrizn.io/v1/public/content/published \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/content/published', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.app.hrizn.io/v1/public/content/published', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.app.hrizn.io/v1/public/content/published",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": [
    {
      "id": "bccf2a98-55ad-437d-b0dc-d505d95c88cf",
      "title": "Land Cruiser vs Bronco Face-Off: Rugged Luxury or Off-Road Fun?",
      "article_type": "comparison",
      "status": "published",
      "slug": "land-cruiser-vs-bronco-rock-hill-comparison",
      "date": "2026-04-11T15:45:37.264+00:00",
      "published_at": "2026-04-11T15:45:37.264+00:00",
      "featured_image": "https://assets.hrizn.io/public/media-library/9c894353.../1771026288320.png",
      "citation_url": "https://www.exampledealer.com/blog/land-cruiser-vs-bronco-rock-hill-comparison",
      "created_at": "2026-02-13T22:56:41.872443+00:00",
      "updated_at": "2026-04-11T15:45:37.297587+00:00"
    },
    {
      "id": "e3e864ce-06fc-477e-b032-8efd8c9e85cf",
      "title": "2026 Toyota Corolla Cross Hybrid Fuel Economy Guide",
      "article_type": "basic",
      "status": "scheduled",
      "slug": "2026-corolla-cross-hybrid-fuel-economy",
      "date": "2026-04-15T09:00:00.000+00:00",
      "published_at": null,
      "featured_image": null,
      "citation_url": null,
      "created_at": "2026-03-01T14:20:00.000+00:00",
      "updated_at": "2026-04-10T18:30:00.000+00:00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wMVQxNDoyMDowMC4wMDArMDA6MDAiLCJpZCI6ImUzZTg2NGNlLTA2ZmMtNDc3ZS1iMDMyLThlZmQ4YzllODVjZiJ9",
    "total_count": 42
  }
}

Returns a paginated list of content with posting_status of published or scheduled. Use this endpoint to discover which content is ready for your CMS or website integration. Scope required: content:read

Query parameters

integer

default:"25"

Results per page (1-100).

string

Pagination cursor from a previous response.

string

Filter by posting status: published or scheduled. Omit to return both.

Response

Each item in the response includes publishing metadata alongside the standard content fields.

string

Posting status: published or scheduled.

string | null

URL slug for the published content.

string | null

ISO 8601 publish or scheduled date in UTC.

string | null

ISO 8601 timestamp in UTC when the content was first published. Null for scheduled content.

All date and time fields — including scheduled post dates — are returned in UTC with a +00:00 offset. Convert to the appropriate local timezone on your side before displaying to end users.

string | null

Fully-resolved URL of the featured image.

string | null

Best available public URL for citing this article (posting canonical → published → posted).

{
  "data": [
    {
      "id": "bccf2a98-55ad-437d-b0dc-d505d95c88cf",
      "title": "Land Cruiser vs Bronco Face-Off: Rugged Luxury or Off-Road Fun?",
      "article_type": "comparison",
      "status": "published",
      "slug": "land-cruiser-vs-bronco-rock-hill-comparison",
      "date": "2026-04-11T15:45:37.264+00:00",
      "published_at": "2026-04-11T15:45:37.264+00:00",
      "featured_image": "https://assets.hrizn.io/public/media-library/9c894353.../1771026288320.png",
      "citation_url": "https://www.exampledealer.com/blog/land-cruiser-vs-bronco-rock-hill-comparison",
      "created_at": "2026-02-13T22:56:41.872443+00:00",
      "updated_at": "2026-04-11T15:45:37.297587+00:00"
    },
    {
      "id": "e3e864ce-06fc-477e-b032-8efd8c9e85cf",
      "title": "2026 Toyota Corolla Cross Hybrid Fuel Economy Guide",
      "article_type": "basic",
      "status": "scheduled",
      "slug": "2026-corolla-cross-hybrid-fuel-economy",
      "date": "2026-04-15T09:00:00.000+00:00",
      "published_at": null,
      "featured_image": null,
      "citation_url": null,
      "created_at": "2026-03-01T14:20:00.000+00:00",
      "updated_at": "2026-04-10T18:30:00.000+00:00"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wMy0wMVQxNDoyMDowMC4wMDArMDA6MDAiLCJpZCI6ImUzZTg2NGNlLTA2ZmMtNDc3ZS1iMDMyLThlZmQ4YzllODVjZiJ9",
    "total_count": 42
  }
}

Use the status query parameter to filter for only published content when building a CMS sync, or only scheduled content to preview upcoming publications.

To retrieve the full publish payload (HTML body, SEO metadata, social tags, schema) for a specific content item, use the Get publish data endpoint.

Authorizations

X-API-Key

string

header

required

Your Hrizn API key (prefix hzk_)

Query Parameters

limit

integer

default:25

Number of results per page

Required range: 1 <= x <= 100

cursor

string

Base64-encoded pagination cursor

status

enum<string>

Filter by posting status. Omit to return both.

Available options:

published,

scheduled

Response

Paginated list of published content

data

object[]

Hide child attributes

data.id

string<uuid>

data.title

string

data.article_type

enum<string>

Available options:

basic,

qa,

expert,

modellanding,

comparison,

salesevent,

enhancedcontent

data.status

enum<string>

Posting status

Available options:

published,

scheduled

data.slug

string | null

URL slug

data.date

string<date-time> | null

Publish or scheduled date (ISO 8601, UTC)

data.published_at

string<date-time> | null

Timestamp when first published (ISO 8601, UTC)

data.featured_image

string | null

Fully-resolved featured image URL

data.citation_url

string | null

Best available public URL for citing this article on the dealer site. Coalesced from posting_canonical_url, then published_url, then posted_url.

data.created_at

string<date-time>

data.updated_at

string<date-time>

pagination

object

Hide child attributes

pagination.has_more

boolean

pagination.next_cursor

string | null

pagination.total_count

integer

Last modified on July 26, 2026

Overview

IdeaClouds

Content Intelligence

Content

Content Types

Compliance

Content Tools

Inventory

Market

Site

Dealership Config

Social

Webhooks

Reference

Health

Analytics

IdeaClouds

Content

Compliance

Content Tools

Inventory

Market

Site

Webhooks

Content Intelligence

Reference

Social

List published content

Query parameters

Response

Authorizations

Query Parameters

Response

​Query parameters

​Response

Authorizations

Query Parameters

Response

Query parameters

Response