curl --request GET \
--url https://api.app.hrizn.io/v1/public/images \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.app.hrizn.io/v1/public/images"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.app.hrizn.io/v1/public/images', 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/images', 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/images",
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": [
{
"image_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"generation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "generating",
"image_url": "<string>",
"error": "<string>",
"source": "ai",
"alt_text": "<string>",
"title": "<string>",
"caption": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"width": 123,
"height": 123,
"aspect_ratio": "16:9",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"generated_at": "2023-11-07T05:31:56Z",
"generation": {
"prompt": "<string>",
"generation_prompt": "<string>",
"disclaimer": "<string>"
},
"article_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parent_image_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"variants": [
{
"image_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"preset_key": "<string>",
"preset_label": "<string>",
"width": 123,
"height": 123,
"aspect_ratio": "1:1",
"image_url": "<string>",
"status": "generating"
}
]
}
],
"pagination": {
"has_more": true,
"next_cursor": "<string>",
"total_count": 123
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}List images
List the site’s Media Library images, newest first. Covers AI-generated, uploaded, OEM, reference, and social-variant assets. Each row is a full Image (alt text, AI metadata, prompts, dimensions, article link) but without variants — call GET /images/ for those. In-flight and failed AI generations are hidden unless status=generating or status=error is passed. Requires images:read.
curl --request GET \
--url https://api.app.hrizn.io/v1/public/images \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.app.hrizn.io/v1/public/images"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.app.hrizn.io/v1/public/images', 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/images', 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/images",
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": [
{
"image_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"generation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "generating",
"image_url": "<string>",
"error": "<string>",
"source": "ai",
"alt_text": "<string>",
"title": "<string>",
"caption": "<string>",
"description": "<string>",
"tags": [
"<string>"
],
"width": 123,
"height": 123,
"aspect_ratio": "16:9",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"generated_at": "2023-11-07T05:31:56Z",
"generation": {
"prompt": "<string>",
"generation_prompt": "<string>",
"disclaimer": "<string>"
},
"article_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"parent_image_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"variants": [
{
"image_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"preset_key": "<string>",
"preset_label": "<string>",
"width": 123,
"height": 123,
"aspect_ratio": "1:1",
"image_url": "<string>",
"status": "generating"
}
]
}
],
"pagination": {
"has_more": true,
"next_cursor": "<string>",
"total_count": 123
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}{
"error": {
"code": "validation_error",
"message": "keyword: Required",
"details": {},
"request_id": "<string>"
}
}Authorizations
Your Hrizn API key (prefix hzk_)
Query Parameters
Number of results per page
1 <= x <= 100Base64-encoded pagination cursor
Restrict to one asset source.
ai, upload, oem, reference, social_variant Generation status. Omit for finished images; generating or error surfaces placeholder rows for in-flight or failed AI generations.
generating, complete, error Only images attached to this content item.
Only images carrying this tag.
Substring match on alt text, title, and description.
Response
Paginated list of images
Hide child attributes
Hide child attributes
generating, complete, error Public asset URL once status is complete.
ai, upload, oem, reference, social_variant Accessibility text. AI images receive an AI-written value after generation.
"16:9"
When the AI render finished (AI images only).
Present for AI-generated images.
Content item this image is attached to, if any.
Set when this image is itself a social variant of another image.
Social variant cuts of this image. Empty on list rows.
Hide child attributes
Hide child attributes
The variant's own Media Library asset id.
Social preset key (igFeedSquare, igFeedPortrait, story, xLandscape, linkedinWide).
"1:1"
generating, complete, error 