---
title: "GET /api/html_interactive_ads/{id}/"
method: GET
path: "/api/html_interactive_ads/{id}/"
tags: ["html_interactive_ads"]
---

# GET /api/html_interactive_ads/{id}/

`GET /api/html_interactive_ads/{id}/`

## Request

- The document declares no server URL.
- Auth: API key in header `X-API-ID` and API key in header `X-API-KEY`

Generate HTML interactive ads for one product, one ad per style.

Create the product first with ``POST /api/links/`` or
``POST /api/links/link_with_params/``; this endpoint takes that link. Async only:
POST returns the job immediately; poll the detail route or supply
``webhook_url``.

## Path parameters

- `id` string, uuid, required

## Response `200`

- APIHtmlInteractiveAd
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `link` string, uuid, required: The product to advertise: a link from POST /api/links/ (scraped from a URL) or POST /api/links/link_with_params/ (your own title and images). Fix its title, images and logo with PUT /api/links/{id}/ first, because the ads are built from exactly what the link holds.
  - `style_ids` string[], required: The styles to use, one ad per style, from GET /api/html_interactive_ads/styles/.
  - `promotion_info` string, nullable: Offer to feature in the ads, e.g. '20% off this week'.
  - `custom_prompt` string, nullable: Extra direction for the ads, e.g. tone or what to emphasize.
  - `max_size_mb` integer: Largest file size per ad, in MB. Images are compressed to fit; an ad that still does not fit fails and is refunded.
  - `webhook_url` string, uri, nullable
  - `status` 'pending' | 'running' | 'done' | 'failed', required: * `pending` - pending * `running` - running * `done` - done * `failed` - failed
  - `failed_reason` string, nullable, required
  - `ads` HtmlInteractiveAdItem[], required
    - `id` string, uuid, required
    - `style_id` string, required
    - `status` 'pending' | 'running' | 'done' | 'failed', required: * `pending` - pending * `running` - running * `done` - done * `failed` - failed
    - `html_url` string, uri, nullable, required: Self-contained HTML file with every asset inlined, ready to upload to an ad network. Tapping the ad opens the product URL.
    - `size_bytes` integer, nullable, required
    - `failed_reason` string, nullable, required
  - `credits_used` number, required: 10 credits per ad; failed ads are refunded.

## Changes

- **2026-11-03** `8423ba73b422`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/creatify/apis/creatify-ai-api/changes/api/html_interactive_ads/:id/get.md)

---

[API](https://skmtc.dev/creatify/apis/creatify-ai-api.md) - [All operations](https://skmtc.dev/creatify/apis/creatify-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/creatify/apis/creatify-ai-api/revisions/8423ba73b422?raw)