# Hrizn API Documentation > Programmatically create content, manage research, and access dealership data with the Hrizn Public API. - [Hrizn Public API](https://api-docs.hrizn.io/index.md): Programmatically create content, manage research, and access dealership data - [Quickstart](https://api-docs.hrizn.io/quickstart.md): Make your first API call in 5 minutes - [Authentication](https://api-docs.hrizn.io/authentication.md): How to authenticate with the Hrizn Public API - [Rate Limiting](https://api-docs.hrizn.io/rate-limiting.md): Understand and work with API rate limits - [Webhooks](https://api-docs.hrizn.io/webhooks.md): Receive real-time notifications when content is ready - [Pagination](https://api-docs.hrizn.io/concepts/pagination.md): Navigate through large result sets - [Errors](https://api-docs.hrizn.io/concepts/errors.md): Error response format and error codes - [Idempotency](https://api-docs.hrizn.io/concepts/idempotency.md): Safely retry requests without duplicate side effects - [Hrizn MCP](https://api-docs.hrizn.io/guides/hrizn-mcp.md): Connect your AI assistant to your dealership's Hrizn data and workflows - [Search and GA4 analytics](https://api-docs.hrizn.io/guides/analytics.md): Read warehoused Search Console and GA4 through the Public API and MCP - [Bulk Content Generation](https://api-docs.hrizn.io/guides/bulk-content-generation.md): Generate hundreds of articles across multiple sites while respecting rate limits - [Content Intelligence](https://api-docs.hrizn.io/guides/content-intelligence.md): Automate content gap analysis and act on AI-generated recommendations via the API - [Social posting & reviews](https://api-docs.hrizn.io/guides/social-posting.md): Publish to social platforms and manage reviews via the API - [Observability](https://api-docs.hrizn.io/guides/observability.md): How Hrizn monitors Public API usage and what integrators should expect - [Scopes Overview](https://api-docs.hrizn.io/scopes/overview.md): Understand how scopes control API key permissions and which endpoints each scope unlocks - [ideaclouds:read](https://api-docs.hrizn.io/scopes/ideaclouds-read.md): List and retrieve IdeaClouds, research questions, and question clusters - [ideaclouds:write](https://api-docs.hrizn.io/scopes/ideaclouds-write.md): Create IdeaClouds individually or in batch to start keyword research - [content:read](https://api-docs.hrizn.io/scopes/content-read.md): List and retrieve content, HTML content, components, and compliance reports - [content:write](https://api-docs.hrizn.io/scopes/content-write.md): Create content and trigger generation from IdeaClouds - [content_intelligence:read](https://api-docs.hrizn.io/scopes/content-intelligence-read.md): List and view content intelligence recommendations, dismiss recommendations - [content_intelligence:write](https://api-docs.hrizn.io/scopes/content-intelligence-write.md): Act on recommendations and bulk-dismiss - [compliance:write](https://api-docs.hrizn.io/scopes/compliance-write.md): Run OEM compliance checks on freeform copy or Hrizn articles and apply suggested fixes - [content_tools:write](https://api-docs.hrizn.io/scopes/content-tools-write.md): Generate SEO metadata, JSON-LD schemas, social snippets, and other content tools - [inventory:read](https://api-docs.hrizn.io/scopes/inventory-read.md): List vehicles, view AI descriptions, access inventory feeds, and check stats - [inventory:write](https://api-docs.hrizn.io/scopes/inventory-write.md): Trigger AI description generation for individual vehicles or in batch - [images:read](https://api-docs.hrizn.io/scopes/images-read.md): List and view Media Library images, alt text, prompts, and social variants - [images:write](https://api-docs.hrizn.io/scopes/images-write.md): Generate AI images into the site Media Library - [analytics:read](https://api-docs.hrizn.io/scopes/analytics-read.md): Read warehoused Google Search Console and GA4 analytics for a site - [market_data:read](https://api-docs.hrizn.io/scopes/market-data-read.md): Hrizn Market Maker — local listings, days supply, competitive set, and pricing insights (Unlimited) - [site:read](https://api-docs.hrizn.io/scopes/site-read.md): View site details, categories, brand voices, elements, and content types - [social:read](https://api-docs.hrizn.io/scopes/social-read.md): List connected social accounts, posts, and reviews across all platforms - [social:write](https://api-docs.hrizn.io/scopes/social-write.md): Create, schedule, update, delete, unpublish, and retry social posts - [reviews:write](https://api-docs.hrizn.io/scopes/reviews-write.md): Generate and publish replies to social reviews - [webhooks:read](https://api-docs.hrizn.io/scopes/webhooks-read.md): List webhook subscriptions and view delivery logs - [webhooks:write](https://api-docs.hrizn.io/scopes/webhooks-write.md): Create, update, delete, and test webhook subscriptions - [API reference](https://api-docs.hrizn.io/api-reference/overview.md): Complete reference for all Hrizn Public API endpoints - [Create IdeaCloud](https://api-docs.hrizn.io/api-reference/ideaclouds/create.md): Start AI-powered keyword research on a topic - [Create IdeaClouds (batch)](https://api-docs.hrizn.io/api-reference/ideaclouds/create-batch.md): Create up to 25 IdeaClouds in a single request - [List create suggestions](https://api-docs.hrizn.io/api-reference/ideaclouds/create-suggestions.md): Compact create-dropdown suggestions (content + Fast Start) with the same act-on / external-suppression filters used by Composer. Requires ideaclouds:write. - [List IdeaClouds](https://api-docs.hrizn.io/api-reference/ideaclouds/list.md): List all IdeaClouds for this site - [Get IdeaCloud](https://api-docs.hrizn.io/api-reference/ideaclouds/get.md): Get details and status of a specific IdeaCloud - [Get IdeaCloud outline](https://api-docs.hrizn.io/api-reference/ideaclouds/get-outline.md): Text-first cluster summary (labels, counts, sample titles) for MCP curation. Prefer over dumping every question. - [Get IdeaCloud cluster](https://api-docs.hrizn.io/api-reference/ideaclouds/get-cluster.md) - [Get IdeaCloud selection](https://api-docs.hrizn.io/api-reference/ideaclouds/get-selection.md) - [Set IdeaCloud selection](https://api-docs.hrizn.io/api-reference/ideaclouds/put-selection.md): Replace draft_selected_question_ids (0–15). Returns full numbered basket. - [Apply recommended selection](https://api-docs.hrizn.io/api-reference/ideaclouds/apply-recommended.md) - [Update IdeaCloud settings](https://api-docs.hrizn.io/api-reference/ideaclouds/patch-settings.md): Persist Composer accordion draft_settings (article type, tone, Layouts, geo, etc.). - [Get IdeaCloud questions](https://api-docs.hrizn.io/api-reference/ideaclouds/get-questions.md): Get the researched questions and clusters from an IdeaCloud - [List recommendations](https://api-docs.hrizn.io/api-reference/content-intelligence/list.md): List AI-generated content intelligence recommendations for this site - [Get recommendation](https://api-docs.hrizn.io/api-reference/content-intelligence/get.md): Get details of a specific content intelligence recommendation - [Get summary](https://api-docs.hrizn.io/api-reference/content-intelligence/summary.md): Get aggregate counts of content intelligence recommendations - [Act on recommendation](https://api-docs.hrizn.io/api-reference/content-intelligence/act.md): Link a recommendation to the article or IdeaCloud created from it - [Dismiss recommendation](https://api-docs.hrizn.io/api-reference/content-intelligence/dismiss.md): Dismiss a content intelligence recommendation - [Bulk dismiss](https://api-docs.hrizn.io/api-reference/content-intelligence/bulk-dismiss.md): Dismiss multiple content intelligence recommendations at once - [Create content](https://api-docs.hrizn.io/api-reference/content/create.md): Generate content from a completed IdeaCloud - [Create content (batch)](https://api-docs.hrizn.io/api-reference/content/create-batch.md): Create up to 10 content items in a single request - [List content](https://api-docs.hrizn.io/api-reference/content/list.md): List all content for this site - [Get content](https://api-docs.hrizn.io/api-reference/content/get.md): Get details and component status of content - [Get content HTML](https://api-docs.hrizn.io/api-reference/content/get-html.md): Get the CMS-ready HTML body of content - [Get content components](https://api-docs.hrizn.io/api-reference/content/get-components.md): Get all components or a specific component type - [Regenerate content](https://api-docs.hrizn.io/api-reference/content/generate.md): Re-trigger body generation for existing IdeaCloud-linked content - [List published content](https://api-docs.hrizn.io/api-reference/content/list-published.md): List content that is published or scheduled - [Get publish data](https://api-docs.hrizn.io/api-reference/content/get-publish-data.md): Get the complete publish payload for CMS integration - [Create vehicle comparison](https://api-docs.hrizn.io/api-reference/content-types/create-comparison.md): Generate a side-by-side comparison from inventory VINs and/or validated catalog YMMT - [Compare trims](https://api-docs.hrizn.io/api-reference/content-types/compare-trims.md): Side-by-side trim comparison for one model year - [Create model landing page](https://api-docs.hrizn.io/api-reference/content-types/create-model-landing.md): Generate a model research / landing page from inventory VIN or validated catalog YMMT - [Create sales event page](https://api-docs.hrizn.io/api-reference/content-types/create-sales-event.md): Generate a promotional page for a dealership event - [Vehicle selection options](https://api-docs.hrizn.io/api-reference/content-types/vehicle-ymmt.md): List supported years, makes, models, and trims for catalog-based content - [Check freeform compliance](https://api-docs.hrizn.io/api-reference/compliance/check.md): Run a sync OEM compliance check on pasted marketing copy - [Apply compliance fixes](https://api-docs.hrizn.io/api-reference/compliance/apply-fixes.md): Apply selected compliance suggested replacements to copy - [Apply compliance decisions](https://api-docs.hrizn.io/api-reference/compliance/apply-to-content.md): Accept or ignore stored compliance findings by issue id - [Trigger compliance check](https://api-docs.hrizn.io/api-reference/compliance/trigger.md): Run an OEM compliance check on content - [Get compliance results](https://api-docs.hrizn.io/api-reference/compliance/get.md): Get compliance check results for content - [Generate content tools](https://api-docs.hrizn.io/api-reference/content-tools/generate.md): Generate SEO metadata, schemas, and social snippets for content - [List inventory](https://api-docs.hrizn.io/api-reference/inventory/list.md): List vehicles in this site's inventory - [Get vehicle safety](https://api-docs.hrizn.io/api-reference/inventory/get-safety.md): Open NHTSA safety recalls for a stocked VIN - [Get vehicle](https://api-docs.hrizn.io/api-reference/inventory/get-vehicle.md): Get full details for a specific vehicle - [Get vehicle description](https://api-docs.hrizn.io/api-reference/inventory/get-description.md): Get the AI-generated description for a vehicle - [Generate description](https://api-docs.hrizn.io/api-reference/inventory/generate-description.md): Trigger AI description generation for a vehicle - [Generate descriptions (batch)](https://api-docs.hrizn.io/api-reference/inventory/generate-description-batch.md): Trigger description generation for up to 50 vehicles - [Get inventory feed](https://api-docs.hrizn.io/api-reference/inventory/get-feed.md): Get the complete inventory feed in JSON or XML format - [Get inventory stats](https://api-docs.hrizn.io/api-reference/inventory/get-stats.md): Get aggregate inventory statistics - [Inventory health](https://api-docs.hrizn.io/api-reference/inventory/get-health.md): Lot health snapshot: aging, mix, heavy models, merchandising gaps - [List images](https://api-docs.hrizn.io/api-reference/images/list.md): List the site's Media Library images with alt text, AI metadata, and article links - [Get image](https://api-docs.hrizn.io/api-reference/images/get-image.md): Read one Media Library image, or poll an asynchronous image generation by image_id - [Generate image](https://api-docs.hrizn.io/api-reference/images/generate.md): Start asynchronous AI image generation into the Media Library - [Hrizn Market Maker overview](https://api-docs.hrizn.io/api-reference/market/overview.md): Hrizn Market Maker endpoints (Unlimited + market_data:read) - [Local market listings](https://api-docs.hrizn.io/api-reference/market/local-listings.md): Live local-market listings for a vehicle segment near the dealership - [Market days supply](https://api-docs.hrizn.io/api-reference/market/days-supply.md): Live market days supply for a vehicle segment - [Competitive set](https://api-docs.hrizn.io/api-reference/market/competitive-set.md): Live dealer-level competitive set for a vehicle segment - [Analyze inventory pricing](https://api-docs.hrizn.io/api-reference/market/inventory-pricing.md): Compare dealership inventory pricing to the live local market - [Appraise a vehicle](https://api-docs.hrizn.io/api-reference/market/appraise.md): Appraise a year/make/model against the live local market without a VIN - [Price-cut candidates](https://api-docs.hrizn.io/api-reference/market/price-cut-candidates.md): Rank aged inventory units that are priced over the local market - [Stocking opportunities](https://api-docs.hrizn.io/api-reference/market/stocking-opportunities.md): Recommend segments to stock or acquire based on local market velocity - [Analyze vehicle position](https://api-docs.hrizn.io/api-reference/market/vehicle-position.md): Price a single inventory VIN vs predicted market and market days supply - [Market price analysis](https://api-docs.hrizn.io/api-reference/market/price-analysis.md): Predicted market price, MSRP, range, and comps for a VIN - [Vehicle options and packages](https://api-docs.hrizn.io/api-reference/market/options-packages.md): Factory options and packages for a VIN - [Get site](https://api-docs.hrizn.io/api-reference/site/get.md): Get details about the site associated with this API key - [Get categories](https://api-docs.hrizn.io/api-reference/site/get-categories.md): List content categories for this site - [Get brand voices](https://api-docs.hrizn.io/api-reference/site/get-brand-voices.md): List brand voices available for this site - [Get elements](https://api-docs.hrizn.io/api-reference/site/get-elements.md): List public-safe site elements (staff, links, target geographies, etc.) - [Get content types](https://api-docs.hrizn.io/api-reference/site/get-content-types.md): List content types enabled for this site - [Get Dealer DNA](https://api-docs.hrizn.io/api-reference/site/get-dealer-dna.md): Returns the dealership's DNA profile — history, mission, values, and more - [Get content disclaimers](https://api-docs.hrizn.io/api-reference/site/get-content-disclaimers.md): Returns content disclaimers configured for the site - [Get site links](https://api-docs.hrizn.io/api-reference/site/get-links.md): Returns all configured dealership links - [Get marketing artifacts](https://api-docs.hrizn.io/api-reference/site/get-marketing.md): Returns all marketing artifacts configured for the site - [Get target geography](https://api-docs.hrizn.io/api-reference/site/get-target-geography.md): Returns all target geography locations with boundaries and AI-generated profiles - [Get staff members](https://api-docs.hrizn.io/api-reference/site/get-staff.md): Returns all staff members configured for the dealership - [List accounts](https://api-docs.hrizn.io/api-reference/social/list-accounts.md): List connected social accounts for this site - [Create post](https://api-docs.hrizn.io/api-reference/social/create-post.md): Create, schedule, or publish a social post across platforms - [List posts](https://api-docs.hrizn.io/api-reference/social/list-posts.md): List social post targets for this site - [Get post](https://api-docs.hrizn.io/api-reference/social/get-post.md): Get a logical post with all of its platform targets - [Update post](https://api-docs.hrizn.io/api-reference/social/update-post.md): Update a draft or scheduled post - [Delete post](https://api-docs.hrizn.io/api-reference/social/delete-post.md): Delete or cancel a post - [Unpublish post](https://api-docs.hrizn.io/api-reference/social/unpublish-post.md): Unpublish a single platform target - [Retry post](https://api-docs.hrizn.io/api-reference/social/retry-post.md): Republish a failed or cancelled post as a new post - [List reviews](https://api-docs.hrizn.io/api-reference/social/list-reviews.md): List reviews for this site - [Get review](https://api-docs.hrizn.io/api-reference/social/get-review.md): Get a single review with its responses - [Generate review reply](https://api-docs.hrizn.io/api-reference/social/generate-reply.md): Generate an AI reply draft for a review - [Publish review reply](https://api-docs.hrizn.io/api-reference/social/publish-reply.md): Publish a reply to a review - [Create webhook](https://api-docs.hrizn.io/api-reference/webhooks/create.md): Create a webhook subscription - [List webhooks](https://api-docs.hrizn.io/api-reference/webhooks/list.md): List all webhook subscriptions for this site - [Update webhook](https://api-docs.hrizn.io/api-reference/webhooks/update.md): Update a webhook subscription - [Delete webhook](https://api-docs.hrizn.io/api-reference/webhooks/delete.md): Delete a webhook subscription - [Test webhook](https://api-docs.hrizn.io/api-reference/webhooks/test.md): Send a test event to a webhook endpoint - [Get webhook deliveries](https://api-docs.hrizn.io/api-reference/webhooks/deliveries.md): View delivery log for a webhook subscription - [Submit Vehicle Spotlight lead](https://api-docs.hrizn.io/api-reference/share/shopper-lead.md): Anonymous shopper inquiry from a public Vehicle Spotlight share page - [Submit profile testimonial](https://api-docs.hrizn.io/api-reference/share/testimonial.md): Anonymous testimonial for a Pro Brand profile share page - [Record share page view](https://api-docs.hrizn.io/api-reference/share/track-view.md): Count one view of a /s/{publicId} share page - [Content types](https://api-docs.hrizn.io/api-reference/reference/content-types.md): List all available content types - [Content intelligence types](https://api-docs.hrizn.io/api-reference/reference/content-intelligence-types.md): List all content intelligence recommendation types with descriptions and recommended actions - [Component types](https://api-docs.hrizn.io/api-reference/reference/component-types.md): List all article component types - [Content tools](https://api-docs.hrizn.io/api-reference/reference/content-tools.md): List all content tool types - [Scopes](https://api-docs.hrizn.io/api-reference/reference/scopes.md): List all API key scopes - [Webhook events](https://api-docs.hrizn.io/api-reference/reference/webhook-events.md): List all webhook event types - [Health check](https://api-docs.hrizn.io/api-reference/reference/health.md): Check if the API is operational - [Health check](https://api-docs.hrizn.io/api-reference/health/health-check.md) - [Submit a Vehicle Spotlight lead](https://api-docs.hrizn.io/api-reference/share/submit-a-vehicle-spotlight-lead.md): Captures a shopper inquiry from a public Vehicle Spotlight share page and enqueues CRM (ADF) delivery. Idempotent on idempotency_key. Rate limit: 8 per minute and 200 per day per client IP. Origin must be the Hrizn app. - [CORS preflight](https://api-docs.hrizn.io/api-reference/share/cors-preflight.md) - [Submit a profile testimonial](https://api-docs.hrizn.io/api-reference/share/submit-a-profile-testimonial.md): Submits an anonymous testimonial for a Pro Brand profile from its share page. Stored as pending until the profile owner approves it. Each profile accepts at most 10 testimonials per rolling 24 hours (429). Rate limit: 5 per minute and 100 per day per client IP. Origin must be the Hrizn app. - [CORS preflight](https://api-docs.hrizn.io/api-reference/share/cors-preflight-1.md) - [Record a share page view](https://api-docs.hrizn.io/api-reference/share/record-a-share-page-view.md): Records one view of a /s/{publicId} share page: writes a page_viewed event to the share ledger and, for article-backed shares, increments the article public_view_count. The share row must exist, be unexpired, and bind to its site. Rate limit: 60 per minute and 5000 per day per client IP. Origin must… - [CORS preflight](https://api-docs.hrizn.io/api-reference/share/cors-preflight-2.md) - [Search snapshot](https://api-docs.hrizn.io/api-reference/analytics/search-snapshot.md) - [List search queries](https://api-docs.hrizn.io/api-reference/analytics/list-search-queries.md) - [List search pages](https://api-docs.hrizn.io/api-reference/analytics/list-search-pages.md) - [Search opportunities](https://api-docs.hrizn.io/api-reference/analytics/search-opportunities.md) - [Search gaps versus published titles](https://api-docs.hrizn.io/api-reference/analytics/search-gaps-versus-published-titles.md) - [Search period-over-period changes](https://api-docs.hrizn.io/api-reference/analytics/search-period-over-period-changes.md) - [Content decay](https://api-docs.hrizn.io/api-reference/analytics/content-decay.md) - [Interrogative and gen-AI exhaust queries](https://api-docs.hrizn.io/api-reference/analytics/interrogative-and-gen-ai-exhaust-queries.md) - [Search alerts](https://api-docs.hrizn.io/api-reference/analytics/search-alerts.md) - [Create-brief from search analysis](https://api-docs.hrizn.io/api-reference/analytics/create-brief-from-search-analysis.md) - [Four-scalar search pulse (REST only)](https://api-docs.hrizn.io/api-reference/analytics/four-scalar-search-pulse-rest-only.md) - [Page performance plus live URL Inspection](https://api-docs.hrizn.io/api-reference/analytics/page-performance-plus-live-url-inspection.md) - [GA4 traffic snapshot](https://api-docs.hrizn.io/api-reference/analytics/ga4-traffic-snapshot.md) - [GA4 traffic pages](https://api-docs.hrizn.io/api-reference/analytics/ga4-traffic-pages.md) - [Vehicle demand insights](https://api-docs.hrizn.io/api-reference/analytics/vehicle-demand-insights.md) - [List IdeaClouds](https://api-docs.hrizn.io/api-reference/ideaclouds/list-ideaclouds.md): Returns a paginated list of IdeaClouds for your site. - [Create IdeaCloud](https://api-docs.hrizn.io/api-reference/ideaclouds/create-ideacloud.md): Creates a new IdeaCloud and begins AI-powered keyword research. - [Create IdeaClouds in batch](https://api-docs.hrizn.io/api-reference/ideaclouds/create-ideaclouds-in-batch.md): Creates multiple IdeaClouds in a single request (1-25 items). - [List IdeaCloud create suggestions](https://api-docs.hrizn.io/api-reference/ideaclouds/list-ideacloud-create-suggestions.md): Compact create-dropdown suggestions (content + Fast Start) with the same act-on / external-suppression filters used by Composer. Requires ideaclouds:write. - [Get IdeaCloud details](https://api-docs.hrizn.io/api-reference/ideaclouds/get-ideacloud-details.md) - [Get IdeaCloud cluster outline](https://api-docs.hrizn.io/api-reference/ideaclouds/get-ideacloud-cluster-outline.md): Text-first cluster summary (labels, counts, sample titles) for MCP curation. Prefer over dumping every question. - [Get questions in one cluster](https://api-docs.hrizn.io/api-reference/ideaclouds/get-questions-in-one-cluster.md) - [Get ordered question basket](https://api-docs.hrizn.io/api-reference/ideaclouds/get-ordered-question-basket.md) - [Replace ordered question basket](https://api-docs.hrizn.io/api-reference/ideaclouds/replace-ordered-question-basket.md): Replace draft_selected_question_ids (0–15). Returns full numbered basket. - [Seed basket from recommended questions](https://api-docs.hrizn.io/api-reference/ideaclouds/seed-basket-from-recommended-questions.md) - [Update IdeaCloud draft settings](https://api-docs.hrizn.io/api-reference/ideaclouds/update-ideacloud-draft-settings.md): Persist Composer accordion draft_settings (article type, tone, Layouts, geo, etc.). - [Get questions and clusters](https://api-docs.hrizn.io/api-reference/ideaclouds/get-questions-and-clusters.md): Returns research questions and clusters. If research is in progress, arrays are empty. - [List content](https://api-docs.hrizn.io/api-reference/content/list-content.md) - [Create content](https://api-docs.hrizn.io/api-reference/content/create-content.md): Creates new content from a completed IdeaCloud and starts generation immediately. - [Create content in batch](https://api-docs.hrizn.io/api-reference/content/create-content-in-batch.md): Creates multiple content items in a single request (1-10 items). - [Get content details](https://api-docs.hrizn.io/api-reference/content/get-content-details.md): Returns article metadata and components. When the article has a canonical URL and the API key includes the `analytics:read` scope, the response may include a `search` object with warehoused Search Console page-performance data. Keys with only `content:read` receive `search: null`. - [Get CMS-ready HTML](https://api-docs.hrizn.io/api-reference/content/get-cms-ready-html.md): Returns CMS-ready HTML for the content body, matching the "Export to HTML" output in the dashboard. For standard (markdown-based) articles the output includes Bootstrap table classes for responsive styling. For AI Designed Layout articles the rendered layout HTML is returned. Every response ends wit… - [Get all components](https://api-docs.hrizn.io/api-reference/content/get-all-components.md) - [Get a single component](https://api-docs.hrizn.io/api-reference/content/get-a-single-component.md) - [Regenerate content](https://api-docs.hrizn.io/api-reference/content/regenerate-content.md): Re-triggers article body generation for existing IdeaCloud-linked content. Question selection is fixed at creation time. Returns 400 if the content is not linked to an IdeaCloud. - [List published content](https://api-docs.hrizn.io/api-reference/content/list-published-content.md): Returns a paginated list of content with posting_status of published or scheduled. - [Get publish data](https://api-docs.hrizn.io/api-reference/content/get-publish-data.md): Get the complete publish payload for CMS integration - [Create vehicle comparison](https://api-docs.hrizn.io/api-reference/content/create-vehicle-comparison.md): Creates a vehicle comparison comparing 2-5 vehicles side-by-side. Each vehicle must declare `source=inventory` (VIN) or `source=catalog` (validated YMMT from `/vehicle-ymmt/*`). Free-text invent is rejected. The comparison is generated asynchronously. Use the returned `id` with `GET /content/{id}` t… - [Create model landing page](https://api-docs.hrizn.io/api-reference/content/create-model-landing-page.md): Creates a model research / landing page from either an inventory VIN (`source=inventory`) or validated catalog YMMT (`source=catalog`). Catalog labels must come from the `/vehicle-ymmt/*` cascade. Supports the same create options used by Composer (tone/voice, depth, geo, Layouts). The page is genera… - [List Layouts templates](https://api-docs.hrizn.io/api-reference/content/list-layouts-templates.md): Lists active web builder templates (Layouts) for model landing or comparison create. Use `selected_template_id` from this list when `output_format=visual` and `visual_design_mode=user-template`. Requires `content:write`. - [Create sales event page](https://api-docs.hrizn.io/api-reference/content/create-sales-event-page.md): Creates a promotional page for a dealership sales event. Supports various event categories including Sales Events, New Model Launches, Service Specials, and more. The page is generated asynchronously. Use the returned `id` with `GET /content/{id}` to check status and retrieve the result. - [List selectable vehicle years](https://api-docs.hrizn.io/api-reference/content/list-selectable-vehicle-years.md): Lists supported years for catalog-based content creation. Requires `content:write`. - [List selectable vehicle years](https://api-docs.hrizn.io/api-reference/content/list-selectable-vehicle-years-1.md): Same as GET /vehicle-ymmt/years. - [List selectable makes for a year](https://api-docs.hrizn.io/api-reference/content/list-selectable-makes-for-a-year.md): Lists supported makes for a selected year. Requires `content:write`. - [List selectable models for year + make](https://api-docs.hrizn.io/api-reference/content/list-selectable-models-for-year-+-make.md): Lists supported models for a selected year and make. Requires `content:write`. - [List selectable trims for year + make + model](https://api-docs.hrizn.io/api-reference/content/list-selectable-trims-for-year-+-make-+-model.md): Lists supported trims for a selected year, make, and model. Requires `content:write`. - [Check freeform copy](https://api-docs.hrizn.io/api-reference/compliance/check-freeform-copy.md): Sync OEM advertising compliance check on arbitrary marketing copy. Requires compliance:write and the Compliance Checking plan feature. Heuristics only — not legal advice. - [Apply compliance fixes](https://api-docs.hrizn.io/api-reference/compliance/apply-compliance-fixes.md): Apply selected compliance suggested replacements to copy. Optionally re-run a compliance check on the revised text. - [Get compliance report](https://api-docs.hrizn.io/api-reference/compliance/get-compliance-report.md) - [Trigger compliance check](https://api-docs.hrizn.io/api-reference/compliance/trigger-compliance-check.md): Starts an asynchronous OEM compliance check on content. - [Generate content tools](https://api-docs.hrizn.io/api-reference/content-tools/generate-content-tools.md): Triggers generation for all or selected content tools on content. - [Generate a single content tool](https://api-docs.hrizn.io/api-reference/content-tools/generate-a-single-content-tool.md) - [List vehicles](https://api-docs.hrizn.io/api-reference/inventory/list-vehicles.md) - [Get inventory feed](https://api-docs.hrizn.io/api-reference/inventory/get-inventory-feed.md): Returns the complete inventory feed in JSON or XML format. - [Get inventory stats](https://api-docs.hrizn.io/api-reference/inventory/get-inventory-stats.md) - [Get inventory health](https://api-docs.hrizn.io/api-reference/inventory/get-inventory-health.md): Lot health snapshot covering aging, inventory mix, high-volume models, and merchandising gaps. - [Generate descriptions in batch](https://api-docs.hrizn.io/api-reference/inventory/generate-descriptions-in-batch.md): Triggers AI description generation for multiple vehicles (1-50 VINs). - [Get vehicle details](https://api-docs.hrizn.io/api-reference/inventory/get-vehicle-details.md) - [Get AI description](https://api-docs.hrizn.io/api-reference/inventory/get-ai-description.md) - [Generate AI description](https://api-docs.hrizn.io/api-reference/inventory/generate-ai-description.md): Triggers AI description generation for a single vehicle. - [Generate AI image](https://api-docs.hrizn.io/api-reference/images/generate-ai-image.md): Starts asynchronous AI image generation into the site Media Library and returns 202 with the image_id (the Media Library asset id). Poll GET /images/{imageId} or subscribe to image.generation.completed / image.generation.failed. Pass asset_id to regenerate an existing generated image in place. Entit… - [List images](https://api-docs.hrizn.io/api-reference/images/list-images.md): 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/{imageId} for those. In-flight and failed AI gener… - [Get image](https://api-docs.hrizn.io/api-reference/images/get-image.md): Read one Media Library image, or poll an asynchronous image generation by image_id - [Local market listings](https://api-docs.hrizn.io/api-reference/market/local-market-listings.md): Live local-market listings for a vehicle segment near the dealership. Dealership ZIP is resolved automatically when zip/state are omitted. Requires Unlimited plan entitlement. - [Local market listings (POST body)](https://api-docs.hrizn.io/api-reference/market/local-market-listings-post-body.md): Same as GET /market/local-listings with a JSON body. - [Market days supply](https://api-docs.hrizn.io/api-reference/market/market-days-supply.md): Active supply, recent sell-through, and implied market days supply for a segment. Requires Unlimited plan entitlement. - [Market days supply (POST body)](https://api-docs.hrizn.io/api-reference/market/market-days-supply-post-body.md) - [Competitive set](https://api-docs.hrizn.io/api-reference/market/competitive-set.md): Live dealer-level competitive set for a vehicle segment - [Competitive set (POST body)](https://api-docs.hrizn.io/api-reference/market/competitive-set-post-body.md) - [Analyze inventory pricing](https://api-docs.hrizn.io/api-reference/market/analyze-inventory-pricing.md): Compare the dealership's matching inventory to the live local market price distribution. Requires Unlimited plan entitlement. - [Appraise a vehicle](https://api-docs.hrizn.io/api-reference/market/appraise-a-vehicle.md): Appraise a year/make/model (optional trim + mileage) against the live local market without a VIN. Requires Unlimited plan entitlement. - [Price-cut candidates](https://api-docs.hrizn.io/api-reference/market/price-cut-candidates.md): Rank aged inventory units that are priced over the local market - [Stocking opportunities](https://api-docs.hrizn.io/api-reference/market/stocking-opportunities.md): Recommend segments to stock or acquire based on local market velocity - [Analyze vehicle position](https://api-docs.hrizn.io/api-reference/market/analyze-vehicle-position.md): Price a single inventory VIN vs predicted market and market days supply. Requires Unlimited plan entitlement. - [Analyze vehicle position (POST body)](https://api-docs.hrizn.io/api-reference/market/analyze-vehicle-position-post-body.md) - [Market price analysis](https://api-docs.hrizn.io/api-reference/market/market-price-analysis.md): Predicted market price, MSRP, range, and comparable listings for a VIN. Requires Unlimited plan entitlement. - [Market price analysis (POST body)](https://api-docs.hrizn.io/api-reference/market/market-price-analysis-post-body.md) - [Vehicle options and packages](https://api-docs.hrizn.io/api-reference/market/vehicle-options-and-packages.md): Factory options and packages for a VIN. Requires Unlimited plan entitlement. - [Get site details](https://api-docs.hrizn.io/api-reference/site/get-site-details.md) - [List categories](https://api-docs.hrizn.io/api-reference/site/list-categories.md) - [List brand voices](https://api-docs.hrizn.io/api-reference/site/list-brand-voices.md) - [List site elements](https://api-docs.hrizn.io/api-reference/site/list-site-elements.md) - [List content types](https://api-docs.hrizn.io/api-reference/site/list-content-types.md) - [Get Dealer DNA](https://api-docs.hrizn.io/api-reference/site/get-dealer-dna.md): Returns the dealership's DNA profile — history, mission, values, and more - [List content disclaimers](https://api-docs.hrizn.io/api-reference/site/list-content-disclaimers.md): Returns all content disclaimers configured for the site. - [List site links](https://api-docs.hrizn.io/api-reference/site/list-site-links.md): Returns all dealership links (SRP pages, service scheduler, credit application, etc.). - [List marketing artifacts](https://api-docs.hrizn.io/api-reference/site/list-marketing-artifacts.md): Returns all marketing artifacts (evergreen messages, why-buys, custom USPs). - [List target geography](https://api-docs.hrizn.io/api-reference/site/list-target-geography.md): Returns all target geography locations with boundaries and AI-generated location profiles. - [List staff members](https://api-docs.hrizn.io/api-reference/site/list-staff-members.md): Returns all staff members configured for the dealership. - [List webhook subscriptions](https://api-docs.hrizn.io/api-reference/webhooks/list-webhook-subscriptions.md) - [Create webhook subscription](https://api-docs.hrizn.io/api-reference/webhooks/create-webhook-subscription.md): Creates a new webhook. The response includes a secret for HMAC verification (only shown once). - [Delete webhook subscription](https://api-docs.hrizn.io/api-reference/webhooks/delete-webhook-subscription.md) - [Update webhook subscription](https://api-docs.hrizn.io/api-reference/webhooks/update-webhook-subscription.md) - [Send test ping](https://api-docs.hrizn.io/api-reference/webhooks/send-test-ping.md): Sends a synchronous test.ping event to the webhook URL. - [Get delivery logs](https://api-docs.hrizn.io/api-reference/webhooks/get-delivery-logs.md) - [List recommendations](https://api-docs.hrizn.io/api-reference/content-intelligence/list-recommendations.md): Returns a paginated list of content intelligence recommendations generated by the nightly gap analysis pipeline. - [Get summary](https://api-docs.hrizn.io/api-reference/content-intelligence/get-summary.md): Returns aggregate counts of content intelligence recommendations by status, priority tier, and type. - [Bulk dismiss](https://api-docs.hrizn.io/api-reference/content-intelligence/bulk-dismiss.md): Dismiss multiple content intelligence recommendations at once - [Get recommendation](https://api-docs.hrizn.io/api-reference/content-intelligence/get-recommendation.md): Returns a single content intelligence recommendation by ID. - [Dismiss recommendation](https://api-docs.hrizn.io/api-reference/content-intelligence/dismiss-recommendation.md): Marks a recommendation as dismissed, removing it from the active list. - [Act on recommendation](https://api-docs.hrizn.io/api-reference/content-intelligence/act-on-recommendation.md): Marks a recommendation as acted on, linking it to the article or IdeaCloud research graph that was created from this recommendation. - [List content types](https://api-docs.hrizn.io/api-reference/reference/list-content-types.md) - [List component types](https://api-docs.hrizn.io/api-reference/reference/list-component-types.md) - [List webhook event types](https://api-docs.hrizn.io/api-reference/reference/list-webhook-event-types.md) - [List available scopes](https://api-docs.hrizn.io/api-reference/reference/list-available-scopes.md) - [List content tools](https://api-docs.hrizn.io/api-reference/reference/list-content-tools.md) - [List content intelligence types](https://api-docs.hrizn.io/api-reference/reference/list-content-intelligence-types.md): Returns all recommendation types generated by the content intelligence pipeline, with descriptions and recommended action endpoints. - [List connected social accounts](https://api-docs.hrizn.io/api-reference/social/list-connected-social-accounts.md): List the social accounts connected for this site across all platforms. Use the returned `account_id` values when creating posts. - [List social post targets](https://api-docs.hrizn.io/api-reference/social/list-social-post-targets.md): List social post targets for the site, newest first. Each item is a single platform target; targets that belong to the same post share a `post_id`. Filter by `platform` or `status`. - [Create / schedule / publish a social post](https://api-docs.hrizn.io/api-reference/social/create-schedule-publish-a-social-post.md): Create a post for one or more connected platforms. Provide `scheduled_for` to schedule, or `publish_now: true` to publish immediately. Publishing is asynchronous; status is reflected on the post record and via `social.post.*` webhooks. - [Get a social post](https://api-docs.hrizn.io/api-reference/social/get-a-social-post.md): Return a logical post with all of its per-platform targets. - [Delete or cancel a post](https://api-docs.hrizn.io/api-reference/social/delete-or-cancel-a-post.md) - [Update a draft or scheduled post](https://api-docs.hrizn.io/api-reference/social/update-a-draft-or-scheduled-post.md) - [Unpublish a platform target](https://api-docs.hrizn.io/api-reference/social/unpublish-a-platform-target.md) - [Republish a failed or cancelled post](https://api-docs.hrizn.io/api-reference/social/republish-a-failed-or-cancelled-post.md) - [List reviews](https://api-docs.hrizn.io/api-reference/social/list-reviews.md): List reviews for this site - [Get a review](https://api-docs.hrizn.io/api-reference/social/get-a-review.md) - [Generate an AI reply draft for a review](https://api-docs.hrizn.io/api-reference/social/generate-an-ai-reply-draft-for-a-review.md): Generate an AI-written reply draft for a review. Returns the draft text and a `response_id` you can later publish. - [Publish a reply to a review](https://api-docs.hrizn.io/api-reference/social/publish-a-reply-to-a-review.md): Publish a reply to a review. Provide `text` to post a new reply, or `response_id` to publish a previously generated draft. - [Scopes](https://api-docs.hrizn.io/concepts/scopes.md): Control what each API key can access ## OpenAPI Specs - [openapi](/openapi.yaml) ## Optional - [Dashboard](https://app.hrizn.io) - [Support](mailto:support@hrizn.io)