Get content - Hrizn API Documentation

Get content details

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

{
  "data": {
    "id": "4d42cdcf-e24f-4123-960e-6c15761fcfcf",
    "title": "Unveiling the Power and Performance of the 2026 Chevy Silverado 3500 DRW",
    "status": "complete",
    "article_type": "basic",
    "category": {
      "id": "b24ad569-f7ce-47ad-be44-cec02c0fab70",
      "name": "2026 Chevy Silverado 3500 DRW"
    },
    "ideacloud": null,
    "metadata": {
      "tone": "BrandVoice:profile-1751473166161",
      "language": "English",
      "maxTokens": 1600
    },
    "components": [
      { "type": "body", "status": "complete", "updated_at": "2026-02-27T21:42:56.625882+00:00" },
      { "type": "searchIntent", "status": "complete", "updated_at": "2026-02-27T21:42:57.458068+00:00" },
      { "type": "imagePrompt", "status": "complete", "updated_at": "2026-02-27T21:43:02.084779+00:00" },
      { "type": "seoMetadata", "status": "complete", "updated_at": "2026-02-27T21:46:57.094555+00:00" },
      { "type": "facebookSnip", "status": "complete", "updated_at": "2026-02-27T21:47:21.541289+00:00" }
    ],
    "created_at": "2026-02-27T21:41:20.418301+00:00",
    "updated_at": "2026-02-27T21:42:56.623718+00:00"
  }
}

GET

content

{id}

Get content details

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

{
  "data": {
    "id": "4d42cdcf-e24f-4123-960e-6c15761fcfcf",
    "title": "Unveiling the Power and Performance of the 2026 Chevy Silverado 3500 DRW",
    "status": "complete",
    "article_type": "basic",
    "category": {
      "id": "b24ad569-f7ce-47ad-be44-cec02c0fab70",
      "name": "2026 Chevy Silverado 3500 DRW"
    },
    "ideacloud": null,
    "metadata": {
      "tone": "BrandVoice:profile-1751473166161",
      "language": "English",
      "maxTokens": 1600
    },
    "components": [
      { "type": "body", "status": "complete", "updated_at": "2026-02-27T21:42:56.625882+00:00" },
      { "type": "searchIntent", "status": "complete", "updated_at": "2026-02-27T21:42:57.458068+00:00" },
      { "type": "imagePrompt", "status": "complete", "updated_at": "2026-02-27T21:43:02.084779+00:00" },
      { "type": "seoMetadata", "status": "complete", "updated_at": "2026-02-27T21:46:57.094555+00:00" },
      { "type": "facebookSnip", "status": "complete", "updated_at": "2026-02-27T21:47:21.541289+00:00" }
    ],
    "created_at": "2026-02-27T21:41:20.418301+00:00",
    "updated_at": "2026-02-27T21:42:56.623718+00:00"
  }
}

Returns content metadata and a summary of its components. Scope required: content:read

Path parameters

string

required

UUID of the content.

Response

status

string

Content status: generating, complete, failed, or awaiting_input.

category

object | null

The category assigned to this content, containing id and name. Returns null if no category is assigned.

ideacloud

object | null

The IdeaCloud used to generate this content, containing id and keyword. Returns null if the content was not generated from an IdeaCloud (e.g. older content).

metadata

object

Flexible metadata object. For API-created content, includes source ("public_api"), api_key_id, and api_creator_label (formatted as “API - Name (email)”). May also contain generation parameters like tone, language, and selected_question_ids.

{
  "data": {
    "id": "4d42cdcf-e24f-4123-960e-6c15761fcfcf",
    "title": "Unveiling the Power and Performance of the 2026 Chevy Silverado 3500 DRW",
    "status": "complete",
    "article_type": "basic",
    "category": {
      "id": "b24ad569-f7ce-47ad-be44-cec02c0fab70",
      "name": "2026 Chevy Silverado 3500 DRW"
    },
    "ideacloud": null,
    "metadata": {
      "tone": "BrandVoice:profile-1751473166161",
      "language": "English",
      "maxTokens": 1600
    },
    "components": [
      { "type": "body", "status": "complete", "updated_at": "2026-02-27T21:42:56.625882+00:00" },
      { "type": "searchIntent", "status": "complete", "updated_at": "2026-02-27T21:42:57.458068+00:00" },
      { "type": "imagePrompt", "status": "complete", "updated_at": "2026-02-27T21:43:02.084779+00:00" },
      { "type": "seoMetadata", "status": "complete", "updated_at": "2026-02-27T21:46:57.094555+00:00" },
      { "type": "facebookSnip", "status": "complete", "updated_at": "2026-02-27T21:47:21.541289+00:00" }
    ],
    "created_at": "2026-02-27T21:41:20.418301+00:00",
    "updated_at": "2026-02-27T21:42:56.623718+00:00"
  }
}

Authorizations

X-API-Key

string

header

required

Your Hrizn API key (prefix hzk_)

Path Parameters

string<uuid>

required

Content ID

Response

Content details

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

data.status

enum<string>

Content generation status

Available options:

generating,

complete,

failed,

awaiting_input

data.category

object

Category assigned to this resource, or null if none.

Hide child attributes

data.category.id

string<uuid>

data.category.name

string

data.ideacloud

object

IdeaCloud that generated this content, or null if not applicable.

Hide child attributes

data.ideacloud.id

string<uuid>

data.ideacloud.keyword

string

data.metadata

object

Flexible metadata object. For API-created content, includes source ("public_api"), api_key_id, and api_creator_label. May also include tone, language, and other generation parameters. Visual builder content includes outputFormat ("standard" or "visual") and optionally visualDesignMode ("template", "custom", or "user-template").

Hide child attributes

data.metadata.source

string | null

Origin of content creation (e.g. "public_api")

data.metadata.api_key_id

string | null

ID of the API key used to create the content

data.metadata.api_creator_label

string | null

Display label for the API key owner (e.g. "API - John Doe (john@example.com)")

data.metadata.outputFormat

enum<string> | null

Whether the content was generated as standard markdown or as a visual layout

Available options:

standard,

visual

data.metadata.visualDesignMode

enum<string> | null

Design mode used for visual content (only present when outputFormat is "visual")

Available options:

template,

custom,

user-template

data.components

object[]

Hide child attributes

data.components.type

enum<string>

Component type identifier (camelCase). The path parameter is case-insensitive (e.g. body, Body, and BODY all work), but the API returns the canonical camelCase form in responses.

Available options:

body,

seoMetadata,

pageSlugs,

postTags,

blogCategories,

searchIntent,

facebookSnip,

twitterSnip,

instagramSnip,

googleBusinessSnip,

videoScript,

articleSchema,

authorSchema,

organizationSchema,

vehicleListingSchema,

faqSchema,

eventSchema,

qaPageSchema,

layout_html

data.components.status

string

data.components.updated_at

string<date-time>

data.created_at

string<date-time>

data.updated_at

string<date-time>

data.content_intent

string | null

Content intent classification (fixed_ops, variable, general)

data.target_audience

string | null

Target audience (in_market_buyer, service_customer, owner, general_public, enthusiast)

data.funnel_stage

string | null

Buyer journey funnel stage (awareness, consideration, decision, retention)

data.content_lifespan

string | null

Content lifespan type (evergreen, seasonal, time_bound)

data.search_intent_type

string | null

Search intent type (informational, commercial, transactional, navigational)

Last modified on March 1, 2026

List content

Get content HTML

Documentation Index

​Path parameters

​Response

Authorizations

Path Parameters

Response

Path parameters

Response